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提供一个组件，用于显示常用的 Actions或控制是有用的。例如，信息使用工具条看 How to Use Tool Bars，java教程中的一部分。
与大多数的外观和感觉，用户可以拖动一个工具条到另一个窗口（除非floatable属性设置为false）。拖动到正确的工作，建议您添加JToolBar实例四个“面”，一个容器的布局管理器是一个BorderLayout，与不添加的孩子任何其他四方。

警告： Swing是线程不安全的。更多信息见Swing's Threading Policy。

警告：序列化该类的对象与以后的Swing版本不兼容。当前的序列化支持适用于短期贮藏或RMI运行相同Swing版本的应用程序之间。为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`s添加到 `JToolBar`。
`AccessibleContext`	`getAccessibleContext()` 获取与此相关的accessiblecontext jtoolbar。
`Component`	`getComponentAtIndex(int i)` 返回指定索引处的组件。
`int`	`getComponentIndex(Component c)` 返回指定组件的索引。
`Insets`	`getMargin()` 返回工具栏边框和它的按钮之间的边缘。
`int`	`getOrientation()` 返回工具栏的当前方向。
`ToolBarUI`	`getUI()` 返回工具栏的当前用户界面。
`String`	`getUIClassID()` 返回呈现此组件的“L”和“F”类的名称。
`boolean`	`isBorderPainted()` 得到 `borderPainted`财产。
`boolean`	`isFloatable()` 得到 `floatable`财产。
`boolean`	`isRollover()` 返回翻转状态。
`protected void`	`paintBorder(Graphics g)` 油漆工具条的边界如果 `borderPainted`属性 `true`。
`protected String`	`paramString()` 返回该 `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

- Constructor Detail
  - JToolBar
```
public JToolBar()
```
    创建一个新的工具条；方向默认为 HORIZONTAL。
  - JToolBar
```
public JToolBar(int orientation)
```
    创建一个新的具有指定 orientation工具条。的 orientation必须是 HORIZONTAL或 VERTICAL。
    
    参数
    
    orientation的定位所需的
  - JToolBar
```
public JToolBar(String name)
```
    创建一个新的具有指定 name工具条。名称作为标题的停靠工具栏。默认的方向是 HORIZONTAL。
    
    参数
    
    name -工具栏的名称
    
    从以下版本开始：
    
    一点三
  - JToolBar
```
public JToolBar(String name,
                int orientation)
```
    创建一个新的与指定的 name和 orientation工具栏。所有其他的构造函数调用此构造函数。如果 orientation是一个无效的值，将抛出一个异常。
    
    参数
    
    name -工具栏的名称
    
    orientation -初始取向--它必须是 HORIZONTAL或 VERTICAL
    
    异常
    
    IllegalArgumentException如果定位不 HORIZONTAL也 VERTICAL
    
    从以下版本开始：
    
    一点三
- 方法详细信息
  - getUI
```
public ToolBarUI getUI()
```
    返回工具栏的当前用户界面。
    
    另请参见：
    
    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，L和F改变通知。为从 UIFactory最新版本替换UI。
    
    重写：
    
    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
  - isBorderPainted
```
public boolean isBorderPainted()
```
    得到 borderPainted财产。
    
    结果
    
    该 borderPainted属性的值
    
    另请参见：
    
    setBorderPainted(boolean)
  - setBorderPainted
```
public void setBorderPainted(boolean b)
```
    集 borderPainted属性，这是 true如果边界应涂。此属性的默认值是 true。一些外观和感觉可能无法实现绘制的边框，他们将忽略此属性。
    
    参数
    
    b -如果是真的，边界是画
    
    另请参见：
    
    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)
```
    设置此工具栏的翻转状态。如果翻转状态是真的然后在工具栏按钮的边框将绘制仅当鼠标指针悬停在他们。此属性的默认值为假。
    一个外观和感觉的实施可能会选择忽略这个属性。
    
    参数
    
    真正的 rollover侧翻工具栏按钮；否则为false
    
    从以下版本开始：
    
    一点四
  - isRollover
```
public boolean isRollover()
```
    返回翻转状态。
    
    结果
    
    如果要绘制滚动条按钮，则为真；否则为假
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    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 Actions添加到 JToolBar。如果一个 null行动通过默认的名称是空的。
    
    参数
    
    a为按钮添加的 Action
    
    结果
    
    新创建的按钮
    
    从以下版本开始：
    
    一点三
    
    另请参见：
    
    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 -组件的指标
    
    另请参见：
    
    Container.add(Component)， Container.add(Component, int)， Container.add(Component, java.lang.Object)， Container.invalidate()， LayoutManager， LayoutManager2
  - paramString
```
protected String paramString()
```
    返回该 JToolBar字符串表示形式。此方法仅用于调试目的，返回的字符串的内容和格式可能会在实现过程中有所不同。返回的字符串是空的但可能不 null。
    
    重写：
    
    paramString 方法重写，继承类 JComponent
    
    结果
    
    这 JToolBar字符串表示形式。
  - setLayout
```
public void setLayout(LayoutManager mgr)
```
    从阶级复制的描述： Container
    
    设置此容器的布局管理器。
    这种方法改变布局的相关信息，因此，无效的组件层次结构。
    
    重写：
    
    setLayout 方法重写，继承类 Container
    
    参数
    
    mgr -指定的布局管理器
    
    另请参见：
    
    Container.doLayout()， Container.getLayout()， Container.invalidate()
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    获取与此相关的accessiblecontext jtoolbar。工具条，该accessiblecontext以一个accessiblejtoolbar形式。一个新的accessiblejtoolbar实例被创建时。
    
    Specified by:
    
    getAccessibleContext 接口 Accessible
    
    重写：
    
    getAccessibleContext 方法重写，继承类 Component
    
    结果
    
    一个accessiblejtoolbar作为本jtoolbar的accessiblecontext

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

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

Constructor Detail

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