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提供一个组件，用于显示常用的 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 Actions添加到 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