Module  java.desktop
软件包  javax.swing

Class JToolBar

  • All Implemented Interfaces:
    ImageObserverMenuContainerSerializableAccessibleSwingConstants


    @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
    另请参见:
    ActionSerialized Form
    • 构造方法详细信息

      • JToolBar

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

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

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

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

      • updateUI

        public void updateUI​()
        来自UIFactory通知,L&F已经改变了。 被要求用UIFactory替换最新版本的UIFactory
        重写:
        updateUIJComponent
        另请参见:
        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​()
        返回工具栏的当前方向。 该值为HORIZONTALVERTICAL
        结果
        表示当前方向的整数 - HORIZONTALVERTICAL
        另请参见:
        setOrientation(int)
      • setOrientation

        @BeanProperty(preferred=true,
                      enumerationValues={"SwingConstants.HORIZONTAL","SwingConstants.VERTICAL"},
                      description="The current orientation of the tool bar")
        public void setOrientation​(int o)
        设置工具栏的方向。 方向必须为值HORIZONTALVERTICAL 如果orientation是无效值,将抛出异常。
        参数
        o - 新方向 - HORIZONTALVERTICAL
        异常
        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 ,当更改 Actionnull如果需要该控件的默认属性更改侦听器),则更新该控件。
        参数
        b - a JButton
        结果
        null
      • paramString

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