Module  java.desktop
软件包  javax.swing

Class JToolBar

  • All Implemented Interfaces:
    ImageObserver ， MenuContainer ， Serializable ， Accessible ， SwingConstants 

    @JavaBean(defaultProperty="UI",
          description="A component which displays commonly used controls or Actions.")
public class JToolBar
extends JComponent
implements SwingConstants, Accessible
    JToolBar提供了一个组件，可用于显示常用的Action或控件。 有关使用工具栏的示例和信息，请参阅“Java教程”中的“ How to Use Tool Bars ”一节。

    大多数外观和感觉，用户可以将工具栏拖出到单独的窗口中（除非floatable属性设置为false ）。 要使拖出工作正常，建议您将JToolBar实例添加到其布局管理器为BorderLayout的容器的四个“侧”之一中，并且不要将子项添加到其他四个“边”中的任何一个。

    警告： Swing不是线程安全的。 欲了解更多信息，请参阅Swing's Threading Policy 。

    警告：此类的序列化对象与将来的Swing版本不兼容。 当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。 从1.4版本开始，所有JavaBeans的长期存储支持已被添加到java.beans软件包中。 请参阅XMLEncoder 。

    从以下版本开始：
    1.2
    另请参见：
    Action ， Serialized Form

    • 构造方法详细信息

      • JToolBar

        public JToolBar​()
        创建一个新的工具栏; 方向默认为HORIZONTAL 。

      • JToolBar

        public JToolBar​(int orientation)
        创建一个新的工具栏与指定的orientation 。 orientation必须是HORIZONTAL或VERTICAL 。
        参数
        orientation - 所需的方向

      • JToolBar

        public JToolBar​(String name)
        用指定的name创建一个新的工具栏。 该名称用作取消停靠的工具栏的标题。 默认方向为HORIZONTAL 。
        参数
        name - 工具栏的名称
        从以下版本开始：
        1.3

      • JToolBar

        public JToolBar​(String name,
                int orientation)
        创建一个新的工具栏与指定的name和orientation 。 所有其他构造函数都调用此构造函数。 如果orientation是无效值，将抛出异常。
        参数
        name - 工具栏的名称
        orientation - 初始方向 - 它必须是 HORIZONTAL或 VERTICAL
        异常
        IllegalArgumentException - 如果方向既不是 HORIZONTAL也不是 VERTICAL
        从以下版本开始：
        1.3

    • 方法详细信息

      • updateUI

        public void updateUI​()
        来自UIFactory通知，L＆F已经改变了。 被要求用UIFactory替换最新版本的UIFactory 。
        重写：
        updateUI在 JComponent
        另请参见：
        JComponent.updateUI()

      • getComponentIndex

        public int getComponentIndex​(Component c)
        返回指定组件的索引。 （注：分隔符占据索引位置。）
        参数
        c - Component
        结果
        一个指示组件位置的整数，其中0是第一个

      • getComponentAtIndex

        public Component getComponentAtIndex​(int i)
        返回指定索引处的组件。
        参数
        i - 组件的位置，其中0是第一个
        结果
        该位置的 Component ，或无效索引的 null

      • setMargin

        @BeanProperty(expert=true,
              description="The margin between the tool bar\'s border and contents")
public void setMargin​(Insets m)
        X- 200 X- 200 200 X- 200 X- 200 200 X- 200 200 X- 200 200 X- 200 200 X- 200 200 X- 200 200 X- 设置为null导致工具栏使用默认边距。 工具栏的默认值Border对象使用此值创建适当的边距。 但是，如果在工具栏上设置了非默认边框，则Border对象有责任创建适当的边距空间（否则此属性将被有效地忽略）。
        参数
        m - 一个 Insets对象，它定义边框和按钮之间的空间
        另请参见：
        Insets

      • getMargin

        public Insets getMargin​()
        返回工具栏边框与其按钮之间的边距。
        结果
        一个包含边距值的 Insets对象
        另请参见：
        Insets

      • isBorderPainted

        public boolean isBorderPainted​()
        获取 borderPainted属性。
        结果
        的价值 borderPainted属性
        另请参见：
        setBorderPainted(boolean)

      • setBorderPainted

        @BeanProperty(expert=true,
              description="Does the tool bar paint its borders?")
public void setBorderPainted​(boolean b)
        设置borderPainted属性，如果要绘制边框，则为true 。 此属性的默认值为true 。 一些外观和感觉可能不会实现画边框; 他们将忽略此属性。
        参数
        b - 如果为true，则绘制边框
        另请参见：
        isBorderPainted()

      • isFloatable

        public boolean isFloatable​()
        获取 floatable属性。
        结果
        的价值 floatable属性
        另请参见：
        setFloatable(boolean)

      • setFloatable

        @BeanProperty(preferred=true,
              description="Can the tool bar be made to float by the user?")
public void setFloatable​(boolean b)
        设置floatable属性，该属性必须为true才能使用户移动工具栏。 通常，可漂浮的工具栏可以拖入同一容器内的不同位置，或者进入其自己的窗口。 该属性的默认值为true 。 有些外观和感觉可能不会实现浮动工具栏; 他们将忽略此属性。
        参数
        b - 如果是true ，工具栏可以移动; 否则为false
        另请参见：
        isFloatable()

      • getOrientation

        public int getOrientation​()
        返回工具栏的当前方向。 该值为HORIZONTAL或VERTICAL 。
        结果
        表示当前方向的整数 - HORIZONTAL或 VERTICAL
        另请参见：
        setOrientation(int)

      • setOrientation

        @BeanProperty(preferred=true,
              enumerationValues={"SwingConstants.HORIZONTAL","SwingConstants.VERTICAL"},
              description="The current orientation of the tool bar")
public void setOrientation​(int o)
        设置工具栏的方向。 方向必须为值HORIZONTAL或VERTICAL 。 如果orientation是无效值，将抛出异常。
        参数
        o - 新方向 - HORIZONTAL或 VERTICAL
        异常
        IllegalArgumentException - 如果方向既不是 HORIZONTAL也不是 VERTICAL
        另请参见：
        getOrientation()

      • setRollover

        @BeanProperty(preferred=true,
              visualUpdate=true,
              description="Will draw rollover button borders in the toolbar.")
public void setRollover​(boolean rollover)
        设置此工具栏的翻转状态。 如果翻转状态为真，则只有当鼠标悬停在其上时，才会绘制工具栏按钮的边框。 此属性的默认值为false。

        执行外观可以选择忽略此属性。

        参数
        rollover - 用于翻转工具栏按钮的true; 否则为虚假
        从以下版本开始：
        1.4

      • isRollover

        public boolean isRollover​()
        返回翻转状态。
        结果
        如果要绘制翻转工具栏按钮，则为true; 否则为虚假
        从以下版本开始：
        1.4
        另请参见：
        setRollover(boolean)

      • addSeparator

        public void addSeparator​()
        将默认大小的分隔符附加到工具栏的末尾。 默认尺寸由当前的外观决定。

      • addSeparator

        public void addSeparator​(Dimension size)
        将指定大小的分隔符追加到工具栏的末尾。
        参数
        size - 分隔符的 Dimension

      • add

        public JButton add​(Action a)
        添加一个新的 JButton调度操作。
        参数
        a - 要添加为新菜单项的 Action对象
        结果
        调动动作的新按钮

      • createActionComponent

        protected JButton createActionComponent​(Action a)
        工厂方法为Action创建JButton添加到JToolBar 。 如果传递null操作，默认名称为空。
        参数
        a - 要添加的按钮的 Action
        结果
        新创建的按钮
        从以下版本开始：
        1.3
        另请参见：
        Action

      • createActionChangeListener

        protected PropertyChangeListener createActionChangeListener​(JButton b)
        返回一个正确配置的 PropertyChangeListener ，当更改 Action或 null如果需要该控件的默认属性更改侦听器），则更新该控件。
        参数
        b - a JButton
        结果
        null

      • paramString

        protected String paramString​()
        返回此JToolBar的字符串表示JToolBar 。 该方法仅用于调试目的，并且返回的字符串的内容和格式可能因实现而异。 返回的字符串可能为空，但可能不是null 。
        重写：
        paramString在 JComponent
        结果
        这个 JToolBar的字符串表示 JToolBar 。