javax.swing

Class JToolBar

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