JToolBar (Java Platform SE 8 )

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - javax.swing.JComponent
    - - javax.swing.JToolBar

All Implemented Interfaces:

ImageObserver ， MenuContainer ， Serializable ， Accessible ， SwingConstants
```
public class JToolBar
extends JComponent
implements SwingConstants, Accessible
```
JToolBar提供了一个组件，可用于显示常用的Action或控件。有关使用工具栏的示例和信息，请参阅Java Tutorial中的 How to Use Tool Bars部分。
大多数外观和感觉，用户可以将工具栏拖出到单独的窗口中（除非floatable属性设置为false ）。要拖出才能正常工作，建议您将JToolBar实例添加到布局管理器为BorderLayout的四个“侧”之一中，并且不要将子项添加到其他四个“边”中的任何一个。

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

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

另请参见：

Action

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected class`	`JToolBar.AccessibleJToolBar` 这个类实现了可访问性支持 `JToolBar`类。
`static class`	`JToolBar.Separator` 工具栏特定的分隔符。

Nested classes/interfaces inherited from class javax.swing.JComponent
JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary
- Fields inherited from class javax.swing.JComponent
  listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
- Fields inherited from class java.awt.Component
  accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
- Fields inherited from interface javax.swing.SwingConstants
  BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
- Fields inherited from interface java.awt.image.ImageObserver
  ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

构造方法摘要

构造方法
Constructor and Description
`JToolBar()` 创建一个新的工具栏; 方向默认为`HORIZONTAL` 。
`JToolBar(int orientation)` 创建一个新的工具栏与指定的 `orientation` 。
`JToolBar(String name)` 创建一个新的工具栏与指定的 `name` 。
`JToolBar(String name, int orientation)` 创建一个新的工具栏，具有指定的 `name`和 `orientation` 。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`JButton`	`add(Action a)` 添加一个新的 `JButton`调度操作。
`protected void`	`addImpl(Component comp, Object constraints, int index)` 如果添加了 `JButton` ，则最初设置为禁用。
`void`	`addSeparator()` 将默认大小的分隔符附加到工具栏的末尾。
`void`	`addSeparator(Dimension size)` 将指定大小的分隔符追加到工具栏的末尾。
`protected PropertyChangeListener`	`createActionChangeListener(JButton b)` 返回正确配置的 `PropertyChangeListener` ，如果需要控件的默认属性更改侦听器，则会更新控件，因为发生了 `Action`更改，或 `null` 。
`protected JButton`	`createActionComponent(Action a)` 工厂方法创建 `JButton`为 `Action`添加到 `JToolBar` 。
`AccessibleContext`	`getAccessibleContext()` 获取与此JToolBar关联的AccessibleContext。
`Component`	`getComponentAtIndex(int i)` 返回指定索引处的组件。
`int`	`getComponentIndex(Component c)` 返回指定组件的索引。
`Insets`	`getMargin()` 返回工具栏边框与其按钮之间的边距。
`int`	`getOrientation()` 返回工具栏的当前方向。
`ToolBarUI`	`getUI()` 返回工具栏的当前UI。
`String`	`getUIClassID()` 返回呈现此组件的L＆F类的名称。
`boolean`	`isBorderPainted()` 获得 `borderPainted`属性。
`boolean`	`isFloatable()` 获取 `floatable`属性。
`boolean`	`isRollover()` 返回翻转状态。
`protected void`	`paintBorder(Graphics g)` 如果 `borderPainted`属性为 `true`则绘制工具栏的边框。
`protected String`	`paramString()` 返回此 `JToolBar`的字符串表示 `JToolBar` 。
`void`	`setBorderPainted(boolean b)` 设置 `borderPainted`属性，如果边框应该被绘制，则为 `true` 。
`void`	`setFloatable(boolean b)` 设置 `floatable`属性，必须为 `true`才能使用户移动工具栏。
`void`	`setLayout(LayoutManager mgr)` 设置此容器的布局管理器。
`void`	`setMargin(Insets m)` 设置工具栏的边框和其按钮之间的边距。
`void`	`setOrientation(int o)` 设置工具栏的方向。
`void`	`setRollover(boolean rollover)` 设置此工具栏的翻转状态。
`void`	`setUI(ToolBarUI ui)` 设置渲染此组件的L＆F对象。
`void`	`updateUI()` 来自 `UIFactory`说L＆F已经改变了。

Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 构造方法详细信息
  - 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
- 方法详细信息
  - getUI
```
public ToolBarUI getUI()
```
    返回工具栏的当前UI。
    
    另请参见：
    
    setUI(javax.swing.plaf.ToolBarUI)
  - setUI
```
public void setUI(ToolBarUI ui)
```
    设置渲染此组件的L＆F对象。
    
    参数
    
    ui - ToolBarUI L＆F对象
    
    另请参见：
    
    UIDefaults.getUI(javax.swing.JComponent)
  - updateUI
```
public void updateUI()
```
    UIFactory的UIFactory表明L＆F已经改变了。被称为用UIFactory替换最新版本的UIFactory 。
    
    重写：
    
    updateUI在 JComponent类
    
    另请参见：
    
    JComponent.updateUI()
  - getUIClassID
```
public String getUIClassID()
```
    返回呈现此组件的L＆F类的名称。
    
    重写：
    
    getUIClassID在 JComponent
    
    结果
    
    字符串“ToolBarUI”
    
    另请参见：
    
    JComponent.getUIClassID() ， UIDefaults.getUI(javax.swing.JComponent)
  - getComponentIndex
```
public int getComponentIndex(Component c)
```
    返回指定组件的索引。（注：分隔符占据索引位置。）
    
    参数
    
    c - 找 Component
    
    结果
    
    一个指示组件位置的整数，其中0是第一个
  - getComponentAtIndex
```
public Component getComponentAtIndex(int i)
```
    返回指定索引处的组件。
    
    参数
    
    i - 组件的位置，其中0是第一个
    
    结果
    
    该位置的 Component ，或无效索引为 null
  - setMargin
```
public void setMargin(Insets m)
```
    设置工具栏的边框和其按钮之间的边距。设置为null导致工具栏使用默认边距。工具栏默认Border对象使用此值创建适当的边距。但是，如果在工具栏上设置了非默认边框，那么Border对象有责任创建适当的边距空间（否则此属性将被有效地忽略）。
    
    参数
    
    m - 一个 Insets对象，用于定义边框和按钮之间的空间
    
    另请参见：
    
    Insets
  - getMargin
```
public Insets getMargin()
```
    返回工具栏边框与其按钮之间的边距。
    
    结果
    
    一个 Insets边距值的 Insets对象
    
    另请参见：
    
    Insets
  - isBorderPainted
```
public boolean isBorderPainted()
```
    获取 borderPainted属性。
    
    结果
    
    该值为 borderPainted属性
    
    另请参见：
    
    setBorderPainted(boolean)
  - setBorderPainted
```
public void setBorderPainted(boolean b)
```
    设置borderPainted属性，如果边框应该被绘制，则为true 。此属性的默认值为true 。一些外观和感觉可能不会实现画边框; 他们将忽略此属性。
    
    参数
    
    b - 如果为true，则绘制边框
    
    另请参见：
    
    isBorderPainted()
  - paintBorder
```
protected void paintBorder(Graphics g)
```
    如果 borderPainted属性为 true则绘制工具栏的边框。
    
    重写：
    
    paintBorder在 JComponent
    
    参数
    
    g - 绘画完成的 Graphics上下文
    
    另请参见：
    
    JComponent.paint(java.awt.Graphics) ， JComponent.setBorder(javax.swing.border.Border)
  - isFloatable
```
public boolean isFloatable()
```
    获取 floatable属性。
    
    结果
    
    该值为 floatable属性
    
    另请参见：
    
    setFloatable(boolean)
  - setFloatable
```
public void setFloatable(boolean b)
```
    设置floatable属性，必须为true才能使用户移动工具栏。通常，浮动工具栏可以拖入同一容器内的不同位置，或者进入其自己的窗口。此属性的默认值为true 。有些外观和感觉可能不会实现浮动工具栏; 他们将忽略此属性。
    
    参数
    
    b - 如果true ，工具栏可以移动; false否则
    
    另请参见：
    
    isFloatable()
  - getOrientation
```
public int getOrientation()
```
    返回工具栏的当前方向。值为HORIZONTAL或VERTICAL 。
    
    结果
    
    表示当前方向的整数 - HORIZONTAL或 VERTICAL
    
    另请参见：
    
    setOrientation(int)
  - setOrientation
```
public void setOrientation(int o)
```
    设置工具栏的方向。方向必须为HORIZONTAL或VERTICAL 。如果orientation是无效值，将抛出异常。
    
    参数
    
    o - 新方向 - HORIZONTAL或 VERTICAL
    
    异常
    
    IllegalArgumentException - 如果方向既不是 HORIZONTAL也不是 VERTICAL
    
    另请参见：
    
    getOrientation()
  - setRollover
```
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的Dimension
  - add
```
public JButton add(Action a)
```
    添加一个新的 JButton调度动作。
    
    参数
    
    a - 要添加为新菜单项的 Action对象
    
    结果
    
    调动动作的新按钮
  - createActionComponent
```
protected JButton createActionComponent(Action a)
```
    JButton的Action的工厂方法添加到JToolBar 。如果传递null操作，默认名称为空。
    
    参数
    
    a - 要添加的按钮的 Action
    
    结果
    
    新创建的按钮
    
    从以下版本开始：
    
    1.3
    
    另请参见：
    
    Action
  - createActionChangeListener
```
protected PropertyChangeListener createActionChangeListener(JButton b)
```
    返回一个正确配置的 PropertyChangeListener ，当更改为 Action时更新控件，如果需要该控件的默认属性更改侦听器，则 null 。
    
    结果
    
    null
  - addImpl
```
protected void addImpl(Component comp,
                       Object constraints,
                       int index)
```
    如果添加了 JButton ，则最初设置为禁用。
    
    重写：
    
    addImpl在 Container
    
    参数
    
    comp - 要增强的组件
    
    constraints - 在组件上强制执行的约束
    
    index - index的索引
    
    另请参见：
    
    Container.add(Component) ， Container.add(Component, int) ， Container.add(Component, java.lang.Object) ， Container.invalidate() ， LayoutManager ， LayoutManager2
  - paramString
```
protected String paramString()
```
    返回此JToolBar的字符串表示JToolBar 。该方法仅用于调试目的，并且返回的字符串的内容和格式可能因实现而异。返回的字符串可能为空，但可能不是null 。
    
    重写：
    
    paramString在 JComponent类
    
    结果
    
    这个 JToolBar的字符串表示 JToolBar 。
  - setLayout
```
public void setLayout(LayoutManager mgr)
```
    描述从类别复制： Container
    
    设置此容器的布局管理器。
    该方法更改布局相关信息，因此使组件层次结构无效。
    
    重写：
    
    setLayout在 Container
    
    参数
    
    mgr - 指定的布局管理器
    
    另请参见：
    
    Container.doLayout() ， Container.getLayout() ， Container.invalidate()
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    获取与此JToolBar关联的AccessibleContext。对于工具栏，AccessibleContext采用AccessibleJToolBar的形式。如有必要，将创建一个新的AccessibleJToolBar实例。
    
    Specified by:
    
    getAccessibleContext在接口 Accessible
    
    重写：
    
    getAccessibleContext在 Component类
    
    结果
    
    一个AccessibleJToolBar，用作此JToolBar的AccessibleContext

Class JToolBar

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JComponent

Nested classes/interfaces inherited from class java.awt.Container

Nested classes/interfaces inherited from class java.awt.Component

Field Summary

Fields inherited from class javax.swing.JComponent

Fields inherited from class java.awt.Component

Fields inherited from interface javax.swing.SwingConstants

Fields inherited from interface java.awt.image.ImageObserver

构造方法摘要

方法摘要

Methods inherited from class javax.swing.JComponent

Methods inherited from class java.awt.Container

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

构造方法详细信息

JToolBar

JToolBar

JToolBar

JToolBar

方法详细信息

getUI

setUI

updateUI

getUIClassID

getComponentIndex

getComponentAtIndex

setMargin

getMargin

isBorderPainted

setBorderPainted

paintBorder

isFloatable

setFloatable

getOrientation

setOrientation

setRollover

isRollover

addSeparator

addSeparator

add

createActionComponent

createActionChangeListener

addImpl

paramString

setLayout

getAccessibleContext