模块  java.desktop
软件包  javax.swing

Class JToolBar

  • 实现的所有接口
    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开始， java.beans软件包中添加了对所有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的最新版本替换UI。
        重写：
        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)
        设置工具栏边框与其按钮之间的边距。 设置为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)
        设置此工具栏的翻转状态。 如果翻转状态为true，则仅当鼠标指针悬停在工具栏按钮上时，才会绘制工具栏按钮的边框。 此属性的默认值为false。

        外观的实现可以选择忽略此属性。

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

      • isRollover

        public boolean isRollover()
        返回翻转状态。
        结果
        如果要绘制翻转工具栏按钮，则为true;否则为false。 否则是假的
        从以下版本开始：
        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)
        工厂方法创建JButton for Action s添加到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 。