javax.swing
类 AbstractButton

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.AbstractButton

所有已实现的接口：

ImageObserver, ItemSelectable, MenuContainer, Serializable, SwingConstants

直接已知子类：

JButton, JMenuItem, JToggleButton

public abstract class AbstractButton
extends JComponent
implements ItemSelectable, SwingConstants

定义按钮和菜单项的一般行为。有关更多信息，请参阅《The Java Tutorial》中的 How to Use Buttons, Check Boxes, and Radio Buttons 一节。

警告：此类的已序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或使用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。

嵌套类摘要

protected class	AbstractButton.AccessibleAbstractButton 此类实现对 AbstractButton 类的可访问性支持。
protected class	AbstractButton.ButtonChangeListener 将 ChangeListener 扩展为可序列化的。

从类 javax.swing.JComponent 继承的嵌套类/接口

JComponent.AccessibleJComponent

从类 java.awt.Container 继承的嵌套类/接口

Container.AccessibleAWTContainer

从类 java.awt.Component 继承的嵌套类/接口

Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

字段摘要

protected ActionListener	actionListener 按钮模型的 ActionListener。
static String	BORDER_PAINTED_CHANGED_PROPERTY 标识是否绘制边框。
protected ChangeEvent	changeEvent 每个按钮实例只需要一个 ChangeEvent，因为事件的惟一状态是 source 属性。
protected ChangeListener	changeListener 按钮模型的 changeListener。
static String	CONTENT_AREA_FILLED_CHANGED_PROPERTY 标识对按钮绘制的内容区域的更改。
static String	DISABLED_ICON_CHANGED_PROPERTY 标识禁用按钮时使用的图标的更改。
static String	DISABLED_SELECTED_ICON_CHANGED_PROPERTY 标识禁用并选定按钮时使用的图标的更改。
static String	FOCUS_PAINTED_CHANGED_PROPERTY 标识是否在边框拥有焦点时突出显示。
static String	HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY 标识按钮的水平对齐方式的更改。
static String	HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY 标识按钮的横向文本位置的更改。
static String	ICON_CHANGED_PROPERTY 标识对表示该按钮的图标的更改。
protected ItemListener	itemListener 按钮模型的 ItemListener。
static String	MARGIN_CHANGED_PROPERTY 标识按钮的边界空白的更改。
static String	MNEMONIC_CHANGED_PROPERTY 标识按钮的助记符中的更改。
protected ButtonModel	model 确定按钮状态的数据模型。
static String	MODEL_CHANGED_PROPERTY 标识按钮模型中的更改。
static String	PRESSED_ICON_CHANGED_PROPERTY 标识对按下按钮时使用的图标的更改。
static String	ROLLOVER_ENABLED_CHANGED_PROPERTY 标识从启用翻转到禁用翻转或者从禁用翻转到启用翻转的更改。
static String	ROLLOVER_ICON_CHANGED_PROPERTY 标识对光标移动到按钮上时使用的图标的更改。
static String	ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY 标识对光标移动到按钮上并选定该按钮时使用的图标的更改。
static String	SELECTED_ICON_CHANGED_PROPERTY 标识对选定按钮时使用的图标的更改。
static String	TEXT_CHANGED_PROPERTY 标识按钮的文本中的更改。
static String	VERTICAL_ALIGNMENT_CHANGED_PROPERTY 标识按钮的垂直对齐方式的更改。
static String	VERTICAL_TEXT_POSITION_CHANGED_PROPERTY 标识按钮的竖向文本位置的更改。

从类 javax.swing.JComponent 继承的字段

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

从类 java.awt.Component 继承的字段

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

从接口 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

从接口 java.awt.image.ImageObserver 继承的字段

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

构造方法摘要

AbstractButton()

方法摘要

void	addActionListener(ActionListener l) 将一个 ActionListener 添加到按钮中。
void	addChangeListener(ChangeListener l) 向按钮添加一个 ChangeListener。
protected void	addImpl(Component comp, Object constraints, int index) 将指定组件添加到此容器的指定索引所在的位置上，参考 Container.addImpl(Component, Object, int) 可获得此方法的完整描述。
void	addItemListener(ItemListener l) 将一个 ItemListener 添加到复选框中。
protected int	checkHorizontalKey(int key, String exception) 验证 key 对于 horizontalAlignment 属性是否合法。
protected int	checkVerticalKey(int key, String exception) 确保 key 是有效的。
protected void	configurePropertiesFromAction(Action a) 该工厂方法根据 Action 实例中的值设置 ActionEvent 源的属性。
protected ActionListener	createActionListener()
protected PropertyChangeListener	createActionPropertyChangeListener(Action a) 该工厂方法创建 PropertyChangeListener，用来在 Action 实例上的属性更改时更新 ActionEvent 源。
protected ChangeListener	createChangeListener() 想以不同的方式处理 ChangeEvent 的子类可以重写此方法，以返回另一个 ChangeListener 实现。
protected ItemListener	createItemListener()
void	doClick() 以编程方式执行“单击”。
void	doClick(int pressTime) 以编程方式执行“单击”。
protected void	fireActionPerformed(ActionEvent event) 通知所有对此事件类型的通知感兴趣的已注册侦听器。
protected void	fireItemStateChanged(ItemEvent event) 通知所有对此事件类型的通知感兴趣的已注册侦听器。
protected void	fireStateChanged() 通知所有对此事件类型的通知感兴趣的已注册侦听器。
Action	getAction() 返回当前为此 ActionEvent 源设置的 Action，如果没有设置任何 Action，则返回 null。
String	getActionCommand() 返回此按钮的动作命令。
ActionListener[]	getActionListeners() 返回使用 addActionListener() 添加到此 AbstractButton 的所有 ActionListener 组成的数组。
ChangeListener[]	getChangeListeners() 返回使用 addChangeListener() 添加到此 AbstractButton 中的所有 ChangeListener 组成的数组。
Icon	getDisabledIcon() 返回禁用按钮时按钮使用的图标。
Icon	getDisabledSelectedIcon() 返回禁用并选择按钮时按钮使用的图标。
int	getDisplayedMnemonicIndex() 以索引形式返回字符，它表示助记符字符，外观应该对其提供装饰。
int	getHorizontalAlignment() 返回图标和文本的水平对齐方式。
int	getHorizontalTextPosition() 返回文本相对于图标的横向位置。
Icon	getIcon() 返回默认图标。
int	getIconTextGap() 返回此按钮中显示的文本与图标之间的间隔量。
ItemListener[]	getItemListeners() 返回使用 addItemListener() 添加到此 AbstractButton 中的所有 ItemListener 组成的数组。
String	getLabel() 已过时。 - 由 getText 取代
Insets	getMargin() 返回按钮边框和标签之间的空白。
int	getMnemonic() 返回当前模型中的键盘助记符。
ButtonModel	getModel() 返回此按钮表示的模型。
long	getMultiClickThreshhold() 获得对按钮按下鼠标到生成相应操作事件所需的时间量（以毫秒为单位）。
Icon	getPressedIcon() 返回按钮的按下图标。
Icon	getRolloverIcon() 返回按钮的翻转图标。
Icon	getRolloverSelectedIcon() 返回按钮的翻转选定图标。
Icon	getSelectedIcon() 返回按钮的选择图标。
Object[]	getSelectedObjects() 返回包含标签的数组（长度为 1），如果没有选择按钮，则返回 null。
String	getText() 返回按钮的文本
ButtonUI	getUI() 返回呈现此组件的 L&F 对象。
int	getVerticalAlignment() 返回文本和图标的垂直对齐方式。
int	getVerticalTextPosition() 返回文本相对于图标的纵向位置。
boolean	imageUpdate(Image img, int infoflags, int x, int y, int w, int h) 重写的此方法在当前 Icon 的 Image 不等于传入的 Image img 时返回 false。
protected void	init(String text, Icon icon)
boolean	isBorderPainted() 获得 borderPainted 属性。
boolean	isContentAreaFilled() 获得 contentAreaFilled 属性。
boolean	isFocusPainted() 获得 paintFocus 属性。
boolean	isRolloverEnabled() 获得 rolloverEnabled 属性。
boolean	isSelected() 返回按钮的状态。
protected void	paintBorder(Graphics g) 如果 BorderPainted 属性为 true 并且按钮有边框，则绘制该按钮边框。
protected String	paramString() 返回此 AbstractButton 的字符串表示形式。
void	removeActionListener(ActionListener l) 从按钮中移除一个 ActionListener。
void	removeChangeListener(ChangeListener l) 从按钮中移除一个 ChangeListener。
void	removeItemListener(ItemListener l) 从按钮中移除一个 ItemListener。
void	setAction(Action a) 设置 ActionEvent 源的 Action。
void	setActionCommand(String actionCommand) 设置此按钮的动作命令。
void	setBorderPainted(boolean b) 设置 borderPainted 属性。
void	setContentAreaFilled(boolean b) 设置 contentAreaFilled 属性。
void	setDisabledIcon(Icon disabledIcon) 设置按钮的禁用图标。
void	setDisabledSelectedIcon(Icon disabledSelectedIcon) 设置按钮的禁用选择图标。
void	setDisplayedMnemonicIndex(int index) 提供关于应该装饰文本中哪一个字符来表示助记符的外观提示。
void	setEnabled(boolean b) 启用（或禁用）按钮。
void	setFocusPainted(boolean b) 设置 paintFocus 属性，对于要绘制的焦点状态，该属性必须为 true。
void	setHorizontalAlignment(int alignment) 设置图标和文本的水平对齐方式。
void	setHorizontalTextPosition(int textPosition) 设置文本相对于图标的横向位置。
void	setIcon(Icon defaultIcon) 设置按钮的默认图标。
void	setIconTextGap(int iconTextGap) 如果图标和文本的属性都已设置，则此属性定义图标和文本之间的间隔。
void	setLabel(String label) 已过时。 - 由 setText(text) 取代
void	setLayout(LayoutManager mgr) 为此容器设置布局管理器，参考 Container.setLayout(LayoutManager) 可获得此方法的完整描述。
void	setMargin(Insets m) 设置按钮边框和标签之间的空白。
void	setMnemonic(char mnemonic) 此方法现在已废弃，请使用 setMnemonic(int) 来设置按钮的助记符。
void	setMnemonic(int mnemonic) 设置当前模型上的键盘助记符。
void	setModel(ButtonModel newModel) 设置此按钮表示的模型。
void	setMultiClickThreshhold(long threshhold) 设置对按钮按下鼠标到生成相应操作事件所需的时间量（以毫秒为单位）。
void	setPressedIcon(Icon pressedIcon) 设置按钮的按下图标。
void	setRolloverEnabled(boolean b) 设置 rolloverEnabled 属性，若需要翻转效果，该属性必须为 true。
void	setRolloverIcon(Icon rolloverIcon) 设置按钮的翻转图标。
void	setRolloverSelectedIcon(Icon rolloverSelectedIcon) 设置按钮的翻转选择图标。
void	setSelected(boolean b) 设置按钮的状态。
void	setSelectedIcon(Icon selectedIcon) 设置按钮的选择图标。
void	setText(String text) 设置按钮的文本。
void	setUI(ButtonUI ui) 设置呈现此组件的 L&F 对象。
void	setVerticalAlignment(int alignment) 设置图标和文本的垂直对齐方式。
void	setVerticalTextPosition(int textPosition) 设置文本相对于图标的纵向位置。
void	updateUI() 将 UI 属性重置为当前外观中的一个值。

从类 javax.swing.JComponent 继承的方法

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getAccessibleContext, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, 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, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, 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, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

从类 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, transferFocusBackward, transferFocusDownCycle, validate, validateTree

从类 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, hide, 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, transferFocusUpCycle

从类 java.lang.Object 继承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

字段详细信息

MODEL_CHANGED_PROPERTY

public static final String MODEL_CHANGED_PROPERTY

标识按钮模型中的更改。

另请参见：

常量字段值

TEXT_CHANGED_PROPERTY

public static final String TEXT_CHANGED_PROPERTY

标识按钮的文本中的更改。

另请参见：

常量字段值

MNEMONIC_CHANGED_PROPERTY

public static final String MNEMONIC_CHANGED_PROPERTY

标识按钮的助记符中的更改。

另请参见：

常量字段值

MARGIN_CHANGED_PROPERTY

public static final String MARGIN_CHANGED_PROPERTY

标识按钮的边界空白的更改。

另请参见：

常量字段值

VERTICAL_ALIGNMENT_CHANGED_PROPERTY

public static final String VERTICAL_ALIGNMENT_CHANGED_PROPERTY

标识按钮的垂直对齐方式的更改。

另请参见：

常量字段值

HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY

public static final String HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY

标识按钮的水平对齐方式的更改。

另请参见：

常量字段值

VERTICAL_TEXT_POSITION_CHANGED_PROPERTY

public static final String VERTICAL_TEXT_POSITION_CHANGED_PROPERTY

标识按钮的竖向文本位置的更改。

另请参见：

常量字段值

HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY

public static final String HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY

标识按钮的横向文本位置的更改。

另请参见：

常量字段值

BORDER_PAINTED_CHANGED_PROPERTY

public static final String BORDER_PAINTED_CHANGED_PROPERTY

标识是否绘制边框。

另请参见：

常量字段值

FOCUS_PAINTED_CHANGED_PROPERTY

public static final String FOCUS_PAINTED_CHANGED_PROPERTY

标识是否在边框拥有焦点时突出显示。

另请参见：

常量字段值

ROLLOVER_ENABLED_CHANGED_PROPERTY

public static final String ROLLOVER_ENABLED_CHANGED_PROPERTY

标识从启用翻转到禁用翻转或者从禁用翻转到启用翻转的更改。

另请参见：

常量字段值

CONTENT_AREA_FILLED_CHANGED_PROPERTY

public static final String CONTENT_AREA_FILLED_CHANGED_PROPERTY

标识对按钮绘制的内容区域的更改。

另请参见：

常量字段值

ICON_CHANGED_PROPERTY

public static final String ICON_CHANGED_PROPERTY

标识对表示该按钮的图标的更改。

另请参见：

常量字段值

PRESSED_ICON_CHANGED_PROPERTY

public static final String PRESSED_ICON_CHANGED_PROPERTY

标识对按下按钮时使用的图标的更改。

另请参见：

常量字段值

SELECTED_ICON_CHANGED_PROPERTY

public static final String SELECTED_ICON_CHANGED_PROPERTY

标识对选定按钮时使用的图标的更改。

另请参见：

常量字段值

ROLLOVER_ICON_CHANGED_PROPERTY

public static final String ROLLOVER_ICON_CHANGED_PROPERTY

标识对光标移动到按钮上时使用的图标的更改。

另请参见：

常量字段值

ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY

public static final String ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY

标识对光标移动到按钮上并选定该按钮时使用的图标的更改。

另请参见：

常量字段值

DISABLED_ICON_CHANGED_PROPERTY

public static final String DISABLED_ICON_CHANGED_PROPERTY

标识禁用按钮时使用的图标的更改。

另请参见：

常量字段值

DISABLED_SELECTED_ICON_CHANGED_PROPERTY

public static final String DISABLED_SELECTED_ICON_CHANGED_PROPERTY

标识禁用并选定按钮时使用的图标的更改。

另请参见：

常量字段值

model

protected ButtonModel model

确定按钮状态的数据模型。

changeListener

protected ChangeListener changeListener

按钮模型的 changeListener。

actionListener

protected ActionListener actionListener

按钮模型的 ActionListener。

itemListener

protected ItemListener itemListener

按钮模型的 ItemListener。

changeEvent

protected transient ChangeEvent changeEvent

每个按钮实例只需要一个 ChangeEvent，因为事件的惟一状态是 source 属性。所生成事件的 source 总是 "this"。

构造方法详细信息

AbstractButton

public AbstractButton()

方法详细信息

getText

public String getText()

返回按钮的文本

返回：

按钮的文本

另请参见：

setText(java.lang.String)

setText

public void setText(String text)

设置按钮的文本。

参数：

text - 用于设置文本的字符串

另请参见：

getText()

isSelected

public boolean isSelected()

返回按钮的状态。如果选定了切换按钮，则返回 true，否则返回 false。

返回：

如果选定了切换按钮，则返回 true，否则返回 false

setSelected

public void setSelected(boolean b)

设置按钮的状态。注意，此方法不会触发 actionEvent。调用 doClick 执行程序上的操作更改。

参数：

b - 如果选择了按钮，则该参数为 true，否则为 false

doClick

public void doClick()

以编程方式执行“单击”。此方法的效果等同于用户按下并随后释放按钮。

doClick

public void doClick(int pressTime)

以编程方式执行“单击”。此方法的效果等同于用户按下并随后释放按钮。可以看到，按钮在“按下”状态下停留 pressTime 毫秒的时间。

参数：

pressTime - “按下”按钮的时间，以毫秒为单位

setMargin

public void setMargin(Insets m)

设置按钮边框和标签之间的空白。将该空白设置为 null 会造成按钮使用默认空白。按钮的默认 Border 对象将使用该值来创建适当的空白。不过，如果在按钮上设置非默认边框，则由 Border 对象负责创建适当的空白（否则此属性将被忽略）。

参数：

m - 边框和标签之间的间隔

getMargin

public Insets getMargin()

返回按钮边框和标签之间的空白。

返回：

一个指定按钮边框和标签之间的空白的 Insets 对象

另请参见：

setMargin(java.awt.Insets)

getIcon

public Icon getIcon()

返回默认图标。

返回：

默认 Icon

另请参见：

setIcon(javax.swing.Icon)

setIcon

public void setIcon(Icon defaultIcon)

设置按钮的默认图标。如果没有显式地设置按下图标，则此图标还被用作“按下”和“禁用”图标。

参数：

defaultIcon - 用作默认图像的图标

另请参见：

getIcon(), setPressedIcon(javax.swing.Icon)

getPressedIcon

public Icon getPressedIcon()

返回按钮的按下图标。

返回：

pressedIcon 属性

另请参见：

setPressedIcon(javax.swing.Icon)

setPressedIcon

public void setPressedIcon(Icon pressedIcon)

设置按钮的按下图标。

参数：

pressedIcon - 用作“按下”图像的图标

另请参见：

getPressedIcon()

getSelectedIcon

public Icon getSelectedIcon()

返回按钮的选择图标。

返回：

selectedIcon 属性

另请参见：

setSelectedIcon(javax.swing.Icon)

setSelectedIcon

public void setSelectedIcon(Icon selectedIcon)

设置按钮的选择图标。

参数：

selectedIcon - 用作“选择”图像的图标

另请参见：

getSelectedIcon()

getRolloverIcon

public Icon getRolloverIcon()

返回按钮的翻转图标。

返回：

rolloverIcon 属性

另请参见：

setRolloverIcon(javax.swing.Icon)

setRolloverIcon

public void setRolloverIcon(Icon rolloverIcon)

设置按钮的翻转图标。

参数：

rolloverIcon - 用作“翻转”图像的图标

另请参见：

getRolloverIcon()

getRolloverSelectedIcon

public Icon getRolloverSelectedIcon()

返回按钮的翻转选定图标。

返回：

rolloverSelectedIcon 属性

另请参见：

setRolloverSelectedIcon(javax.swing.Icon)

setRolloverSelectedIcon

public void setRolloverSelectedIcon(Icon rolloverSelectedIcon)

设置按钮的翻转选择图标。

参数：

rolloverSelectedIcon - 用作“选择翻转”图像的图标

另请参见：

getRolloverSelectedIcon()

getDisabledIcon

public Icon getDisabledIcon()

返回禁用按钮时按钮使用的图标。如果没有设置禁用图标，则此方法将调用转发给外观，以构造适当的禁用 Icon。

一些外观上可能没有呈现禁用图标，在这种情况下，它们将忽略此图标。

返回：

disabledIcon 属性

另请参见：

getPressedIcon(), setDisabledIcon(javax.swing.Icon), LookAndFeel.getDisabledIcon(javax.swing.JComponent, javax.swing.Icon)

setDisabledIcon

public void setDisabledIcon(Icon disabledIcon)

设置按钮的禁用图标。

参数：

disabledIcon - 用作禁用图像的图标

另请参见：

getDisabledIcon()

getDisabledSelectedIcon

public Icon getDisabledSelectedIcon()

返回禁用并选择按钮时按钮使用的图标。如果没有设置禁用选择图标，则将调用转发给 LookAndFeel，以从选择图标中（如果已设置）构造适当的禁用图标；否则将调用转发给 getDisabledIcon()。

一些外观上可能没有呈现禁用选择 Icon，在这种情况下，它们将忽略此图标。

返回：

disabledSelectedIcon 属性

另请参见：

getDisabledIcon(), setDisabledSelectedIcon(javax.swing.Icon), LookAndFeel.getDisabledSelectedIcon(javax.swing.JComponent, javax.swing.Icon)

setDisabledSelectedIcon

public void setDisabledSelectedIcon(Icon disabledSelectedIcon)

设置按钮的禁用选择图标。

参数：

disabledSelectedIcon - 用作禁用选择图像的图标

另请参见：

getDisabledSelectedIcon()

getVerticalAlignment

public int getVerticalAlignment()

返回文本和图标的垂直对齐方式。

返回：

verticalAlignment 属性，它是以下值之一：

• SwingConstants.CENTER（默认值）
• SwingConstants.TOP
• SwingConstants.BOTTOM

setVerticalAlignment

public void setVerticalAlignment(int alignment)

设置图标和文本的垂直对齐方式。

参数：

alignment - 它是以下值之一：

• SwingConstants.CENTER（默认值）
• SwingConstants.TOP
• SwingConstants.BOTTOM

getHorizontalAlignment

public int getHorizontalAlignment()

返回图标和文本的水平对齐方式。

返回：

horizontalAlignment 属性，它是以下值之一：

• SwingConstants.RIGHT（默认值）
• SwingConstants.LEFT
• SwingConstants.CENTER
• SwingConstants.LEADING
• SwingConstants.TRAILING

setHorizontalAlignment

public void setHorizontalAlignment(int alignment)

设置图标和文本的水平对齐方式。

参数：

alignment - 它是以下值之一：

• SwingConstants.RIGHT（默认值）
• SwingConstants.LEFT
• SwingConstants.CENTER
• SwingConstants.LEADING
• SwingConstants.TRAILING

getVerticalTextPosition

public int getVerticalTextPosition()

返回文本相对于图标的纵向位置。

返回：

verticalTextPosition 属性，它是以下值之一：

• SwingConstants.CENTER（默认值）
• SwingConstants.TOP
• SwingConstants.BOTTOM

setVerticalTextPosition

public void setVerticalTextPosition(int textPosition)

设置文本相对于图标的纵向位置。

参数：

textPosition - 它是以下值之一：

• SwingConstants.CENTER（默认值）
• SwingConstants.TOP
• SwingConstants.BOTTOM

getHorizontalTextPosition

public int getHorizontalTextPosition()

返回文本相对于图标的横向位置。

返回：

horizontalTextPosition 属性，它是以下值之一：

• SwingConstants.RIGHT
• SwingConstants.LEFT
• SwingConstants.CENTER
• SwingConstants.LEADING
• SwingConstants.TRAILING（默认值）

setHorizontalTextPosition

public void setHorizontalTextPosition(int textPosition)

设置文本相对于图标的横向位置。

参数：

textPosition - 它是以下值之一：

• SwingConstants.RIGHT
• SwingConstants.LEFT
• SwingConstants.CENTER
• SwingConstants.LEADING
• SwingConstants.TRAILING（默认值）

抛出：

IllegalArgumentException - 如果 textPosition 不是上面列出的合法值之一

getIconTextGap

public int getIconTextGap()

返回此按钮中显示的文本与图标之间的间隔量。

返回：

等于文本与图标之间的像素数的 int 值。

从以下版本开始：

1.4

另请参见：

setIconTextGap(int)

setIconTextGap

public void setIconTextGap(int iconTextGap)

如果图标和文本的属性都已设置，则此属性定义图标和文本之间的间隔。

此属性的默认值为 4 个像素。

这是一个 JavaBeans bound 属性。

从以下版本开始：

1.4

另请参见：

getIconTextGap()

checkHorizontalKey

protected int checkHorizontalKey(int key,
                                 String exception)

验证 key 对于 horizontalAlignment 属性是否合法。

参数：

key - 要检查的属性值，它是以下值之一：

• SwingConstants.RIGHT（默认值）
• SwingConstants.LEFT
• SwingConstants.CENTER
• SwingConstants.LEADING
• SwingConstants.TRAILING

exception - IllegalArgumentException 细节消息

抛出：

IllegalArgumentException - 如果 key 不是上面列出的合法值之一

另请参见：

setHorizontalTextPosition(int), setHorizontalAlignment(int)

checkVerticalKey

protected int checkVerticalKey(int key,
                               String exception)

确保 key 是有效的。否则抛出 IllegalArgumentException 异常。

参数：

key - 要检查的值，它是以下值之一：

• SwingConstants.CENTER（默认值）
• SwingConstants.TOP
• SwingConstants.BOTTOM

exception - 在 key 不是上面列出的合法值之一时，传递给 IllegalArgumentException 调用的字符串

抛出：

IllegalArgumentException - 如果 key 不是上面列出的合法值之一

setActionCommand

public void setActionCommand(String actionCommand)

设置此按钮的动作命令。

参数：

actionCommand - 此按钮的动作命令

getActionCommand

public String getActionCommand()

返回此按钮的动作命令。

返回：

此按钮的动作命令

setAction

public void setAction(Action a)

设置 ActionEvent 源的 Action。新 Action 将替换所有以前设置的 Action，但不影响单独使用 addActionListener 添加的 ActionListener。如果 Action 已经是按钮的已注册 ActionListener，则它不需要重新注册。

设置 Action 的副效应是根据 Action 的值立即设置 ActionEvent 源的属性（由 configurePropertiesFromAction 方法执行），并随后根据 Action 的属性的更改进行更新（通过 createActionPropertyChangeListener 方法创建的 PropertyChangeListener）。

参数：

a - AbstractButton 的 Action，或为 null

从以下版本开始：

1.3

另请参见：

Action, getAction(), configurePropertiesFromAction(javax.swing.Action), createActionPropertyChangeListener(javax.swing.Action)

getAction

public Action getAction()

返回当前为此 ActionEvent 源设置的 Action，如果没有设置任何 Action，则返回 null。

返回：

此 ActionEvent 源的 Action，或 null

从以下版本开始：

1.3

另请参见：

Action, setAction(javax.swing.Action)

configurePropertiesFromAction

protected void configurePropertiesFromAction(Action a)

该工厂方法根据 Action 实例中的值设置 ActionEvent 源的属性。已设置的属性对于子类来说可能有所不同。默认情况下，被设置的属性是 Text、Icon、Enabled、ToolTipText、ActionCommand 和 Mnemonic。

如果传入的 Action 是 null，则执行以下设置：

• text 被设置为 null，
• icon 被设置为 null，
• enabled 被设置为 true，
• tooltip text 被设置为 null

参数：

a - 从中获得属性的 Action，或为 null

从以下版本开始：

1.3

另请参见：

Action, setAction(javax.swing.Action)

createActionPropertyChangeListener

protected PropertyChangeListener createActionPropertyChangeListener(Action a)

该工厂方法创建 PropertyChangeListener，用来在 Action 实例上的属性更改时更新 ActionEvent 源。如果子类应当保持更新的属性组不同于默认属性（Text、Icon、Enabled、ToolTipText、Mnemonic），则可以重写此方法以提供它们自己的 PropertyChangeListener。

注意，PropertyChangeListener 应该避免保持对 ActionEvent 源的强引用，因为这可能妨碍 ActionEvent 源及其包含层次结构中所有组件的垃圾回收。

参数：

a - 按钮的新操作

从以下版本开始：

1.3

另请参见：

Action, setAction(javax.swing.Action)

isBorderPainted

public boolean isBorderPainted()

获得 borderPainted 属性。

返回：

borderPainted 属性的值

另请参见：

setBorderPainted(boolean)

setBorderPainted

public void setBorderPainted(boolean b)

设置 borderPainted 属性。如果该属性为 true 并且按钮有边框，则绘制该边框。borderPainted 属性的默认值为 true。

参数：

b - 如果为 true 并且边框属性不为 null，则绘制该边框

另请参见：

isBorderPainted()

paintBorder

protected void paintBorder(Graphics g)

如果 BorderPainted 属性为 true 并且按钮有边框，则绘制该按钮边框。

覆盖：

类 JComponent 中的 paintBorder

参数：

g - 在其中进行绘制的 Graphics 环境

另请参见：

JComponent.paint(java.awt.Graphics), JComponent.setBorder(javax.swing.border.Border)

isFocusPainted

public boolean isFocusPainted()

获得 paintFocus 属性。

返回：

paintFocus 属性

另请参见：

setFocusPainted(boolean)

setFocusPainted

public void setFocusPainted(boolean b)

设置 paintFocus 属性，对于要绘制的焦点状态，该属性必须为 true。paintFocus 属性的默认值为 true。一些外观没有绘制焦点状态；它们将忽略此属性。

参数：

b - 如果为 true，则应绘制焦点状态

另请参见：

isFocusPainted()

isContentAreaFilled

public boolean isContentAreaFilled()

获得 contentAreaFilled 属性。

返回：

contentAreaFilled 属性

另请参见：

setContentAreaFilled(boolean)

setContentAreaFilled

public void setContentAreaFilled(boolean b)

设置 contentAreaFilled 属性。如果该属性为 true，则按钮将绘制内容区域。如果希望有一个透明的按钮，比如只是一个图标的按钮，那么应该将此属性设置为 false。不要调用 setOpaque(false)。contentAreaFilled 属性的默认值为 true。

此方法可能造成组件的 opaque 属性发生更改。

调用此方法的具体行为在各个组件和各个 L&F 之间是各不相同的。

参数：

b - 如果为 true，则应该填充内容；如果为 false，则不填充内容区域

另请参见：

isContentAreaFilled(), JComponent.setOpaque(boolean)

isRolloverEnabled

public boolean isRolloverEnabled()

获得 rolloverEnabled 属性。

返回：

rolloverEnabled 属性的值

另请参见：

setRolloverEnabled(boolean)

setRolloverEnabled

public void setRolloverEnabled(boolean b)

设置 rolloverEnabled 属性，若需要翻转效果，该属性必须为 true。rolloverEnabled 属性的默认值为 false。一些外观也许不实现翻转效果；它们将忽略此属性。

参数：

b - 如果为 true，则应绘制翻转效果

另请参见：

isRolloverEnabled()

getMnemonic

public int getMnemonic()

返回当前模型中的键盘助记符。

返回：

模型中的键盘助记符

setMnemonic

public void setMnemonic(int mnemonic)

设置当前模型上的键盘助记符。助记符是某种键，它与外观的无鼠标修饰符（通常是 Alt）组合时（如果焦点被包含在此按钮祖先窗口中的某个地方）将激活此按钮。

一个助记符必须对应键盘上的一个键，并且应该使用 java.awt.event.KeyEvent 中定义的 VK_XXX 键代码之一指定。助记符是不区分大小写的，所以具有相应键代码的键事件将造成按钮被激活，不管是否按下 Shift 修饰符。

如果在按钮的标签字符串中发现由助记符定义的字符，则第一个出现的助记符将是带下划线的，以向用户指示该助记符。

参数：

mnemonic - 表示助记符的键代码

另请参见：

KeyEvent, setDisplayedMnemonicIndex(int)

setMnemonic

public void setMnemonic(char mnemonic)

此方法现在已废弃，请使用 setMnemonic(int) 来设置按钮的助记符。此方法仅设计用于处理 'a' 到 'z' 或 'A' 到 'Z'之间的字符值。

参数：

mnemonic - 指定助记符值的 char

另请参见：

setMnemonic(int)

setDisplayedMnemonicIndex

public void setDisplayedMnemonicIndex(int index)
                               throws IllegalArgumentException

提供关于应该装饰文本中哪一个字符来表示助记符的外观提示。并不是所有的外观都能支持此方法。值 -1 指示没有助记符（助记符字符没有包含在字符串中），或者开发人员不希望显示助记符。

与助记符相关的属性发生更改时（比如助记符本身、文本……），此索引值也被更改。如果不希望默认字符带下划线，那么只能不断地调用此方法。例如，如果文本 'Save As' 带有一个助记符 'a'，您想装饰 'A'（比如装饰成 'Save As'），那么您必须在调用 setMnemonic(KeyEvent.VK_A) 之后调用 setDisplayedMnemonicIndex(5)。

参数：

index - String 中的索引，指示要加下划线的字符

抛出：

IllegalArgument - 如果 index >= 文本的长度，或者 < -1，则抛出该异常

IllegalArgumentException

从以下版本开始：

1.4

另请参见：

getDisplayedMnemonicIndex()

getDisplayedMnemonicIndex

public int getDisplayedMnemonicIndex()

以索引形式返回字符，它表示助记符字符，外观应该对其提供装饰。

返回：

表示助记符字符的索引

从以下版本开始：

1.4

另请参见：

setDisplayedMnemonicIndex(int)

setMultiClickThreshhold

public void setMultiClickThreshhold(long threshhold)

设置对按钮按下鼠标到生成相应操作事件所需的时间量（以毫秒为单位）。在最初按下鼠标（并生成操作事件）之后，发生在小于 threshhold 的时间间隔中的所有后续鼠标按下事件都将被忽略，并且不生成相应的操作事件。默认情况下，threshhold 为 0，这意味着对于每个鼠标按下操作，都将触发操作事件，无论单击鼠标的速度有多快。在不需要此行为的按钮中（比如对话框中的 "OK" 按钮），应该将此 threshhold 设置为一个适当的正值。

参数：

threshhold - 按下鼠标到生成相应动作事件所需的时间量

抛出：

IllegalArgumentException - 如果 threshhold < 0

从以下版本开始：

1.4

另请参见：

getMultiClickThreshhold()

getMultiClickThreshhold

public long getMultiClickThreshhold()

获得对按钮按下鼠标到生成相应操作事件所需的时间量（以毫秒为单位）。

返回：

按下鼠标到生成相应动作事件所需的时间量

从以下版本开始：

1.4

另请参见：

setMultiClickThreshhold(long)

getModel

public ButtonModel getModel()

返回此按钮表示的模型。

返回：

model 属性

另请参见：

setModel(javax.swing.ButtonModel)

setModel

public void setModel(ButtonModel newModel)

设置此按钮表示的模型。

参数：

newModel - 新的 ButtonModel

另请参见：

getModel()

getUI

public ButtonUI getUI()

返回呈现此组件的 L&F 对象。

返回：

ButtonUI 对象

另请参见：

setUI(javax.swing.plaf.ButtonUI)

setUI

public void setUI(ButtonUI ui)

设置呈现此组件的 L&F 对象。

参数：

ui - ButtonUI L&F 对象

另请参见：

getUI()

updateUI

public void updateUI()

将 UI 属性重置为当前外观中的一个值。AbstractButton 的子类型应该重写此方法来更新 UI。例如，JButton 可以做以下操作：

      setUI((ButtonUI)UIManager.getUI(
          "ButtonUI", "javax.swing.plaf.basic.BasicButtonUI", this));
 

覆盖：

类 JComponent 中的 updateUI

另请参见：

JComponent.setUI(javax.swing.plaf.ComponentUI), UIManager.getLookAndFeel(), UIManager.getUI(javax.swing.JComponent)

addImpl

protected void addImpl(Component comp,
                       Object constraints,
                       int index)

将指定组件添加到此容器的指定索引所在的位置上，参考 Container.addImpl(Component, Object, int) 可获得此方法的完整描述。

覆盖：

类 Container 中的 addImpl

参数：

comp - 要添加的组件

constraints - 表示此组件的布局约束的对象

index - 容器列表中插入组件的位置，-1 表示追加到列表的末尾

抛出：

IllegalArgumentException - 如果 index 无效

IllegalArgumentException - 如果将容器的父容器添加到该容器自身中

IllegalArgumentException - 如果将一个窗口添加到容器中

从以下版本开始：

1.5

另请参见：

Container.add(Component), Container.add(Component, int), Container.add(Component, java.lang.Object), LayoutManager, LayoutManager2

setLayout

public void setLayout(LayoutManager mgr)

为此容器设置布局管理器，参考 Container.setLayout(LayoutManager) 可获得此方法的完整描述。

覆盖：

类 Container 中的 setLayout

参数：

mgr - 指定的布局管理器

从以下版本开始：

1.5

另请参见：

Container.doLayout(), Container.getLayout()

addChangeListener

public void addChangeListener(ChangeListener l)

向按钮添加一个 ChangeListener。

参数：

l - 要添加的侦听器

removeChangeListener

public void removeChangeListener(ChangeListener l)

从按钮中移除一个 ChangeListener。

参数：

l - 要移除的侦听器

getChangeListeners

public ChangeListener[] getChangeListeners()

返回使用 addChangeListener() 添加到此 AbstractButton 中的所有 ChangeListener 组成的数组。

返回：

添加的所有 ChangeListener，如果没有添加侦听器，则返回一个空数组

从以下版本开始：

1.4

fireStateChanged

protected void fireStateChanged()

通知所有对此事件类型的通知感兴趣的已注册侦听器。以延迟方式创建事件实例。

另请参见：

EventListenerList

addActionListener

public void addActionListener(ActionListener l)

将一个 ActionListener 添加到按钮中。

参数：

l - 要添加的 ActionListener

removeActionListener

public void removeActionListener(ActionListener l)

从按钮中移除一个 ActionListener。如果侦听器是按钮当前设置的 Action，则将 Action 设置为 null。

参数：

l - 要移除的侦听器

getActionListeners

public ActionListener[] getActionListeners()

返回使用 addActionListener() 添加到此 AbstractButton 的所有 ActionListener 组成的数组。

返回：

添加的所有 ActionListener，如果没有添加侦听器，则返回一个空数组

从以下版本开始：

1.4

createChangeListener

protected ChangeListener createChangeListener()

想以不同的方式处理 ChangeEvent 的子类可以重写此方法，以返回另一个 ChangeListener 实现。

返回：

新的 ChangeListener

fireActionPerformed

protected void fireActionPerformed(ActionEvent event)

通知所有对此事件类型的通知感兴趣的已注册侦听器。使用 event 参数以延迟方式创建事件实例。

参数：

event - ActionEvent 对象

另请参见：

EventListenerList

fireItemStateChanged

protected void fireItemStateChanged(ItemEvent event)

通知所有对此事件类型的通知感兴趣的已注册侦听器。使用 event 参数以延迟方式创建事件实例。

参数：

event - ItemEvent 对象

另请参见：

EventListenerList

createActionListener

protected ActionListener createActionListener()

createItemListener

protected ItemListener createItemListener()

setEnabled

public void setEnabled(boolean b)

启用（或禁用）按钮。

覆盖：

类 JComponent 中的 setEnabled

参数：

b - true 表示启用按钮，否则为 false

另请参见：

Component.isEnabled(), Component.isLightweight()

getLabel

@Deprecated
public String getLabel()

已过时。 - 由 getText 取代

返回标签文本。

返回：

包含标签的 String

setLabel

@Deprecated
public void setLabel(String label)

已过时。 - 由 setText(text) 取代

设置标签文本。

参数：

label - 包含文本的 String

addItemListener

public void addItemListener(ItemListener l)

将一个 ItemListener 添加到复选框中。

指定者：

接口 ItemSelectable 中的 addItemListener

参数：

l - 要添加的 ItemListener

另请参见：

ItemEvent

removeItemListener

public void removeItemListener(ItemListener l)

从按钮中移除一个 ItemListener。

指定者：

接口 ItemSelectable 中的 removeItemListener

参数：

l - 要移除的 ItemListener

另请参见：

ItemEvent

getItemListeners

public ItemListener[] getItemListeners()

返回使用 addItemListener() 添加到此 AbstractButton 中的所有 ItemListener 组成的数组。

返回：

添加的所有 ItemListener，如果没有添加侦听器，则返回一个空数组

从以下版本开始：

1.4

getSelectedObjects

public Object[] getSelectedObjects()

返回包含标签的数组（长度为 1），如果没有选择按钮，则返回 null。

指定者：

接口 ItemSelectable 中的 getSelectedObjects

返回：

包含 1 个 Object 的数组：按钮的文本，如果选择该项；否则返回 null

init

protected void init(String text,
                    Icon icon)

imageUpdate

public boolean imageUpdate(Image img,
                           int infoflags,
                           int x,
                           int y,
                           int w,
                           int h)

重写的此方法在当前 Icon 的 Image 不等于传入的 Image img 时返回 false。

指定者：

接口 ImageObserver 中的 imageUpdate

覆盖：

类 Component 中的 imageUpdate

参数：

img - 要比较的 Image

infoflags - 更新图像时用于重绘按钮的标志，它确定将绘制多大的区域

x - x 坐标

y - y 坐标

w - 宽度

h - 高度

返回：

如果 infoflags 表明已完全加载了图像，则返回 false；否则返回 true。

另请参见：

ImageObserver, Component.imageUpdate(java.awt.Image, int, int, int, int, int)

paramString

protected String paramString()

返回此 AbstractButton 的字符串表示形式。此方法仅在进行调试的时候使用，对于各个实现，所返回字符串的内容和格式可能有所不同。返回的字符串可能为空，但不可能为 null。

重写 paramString 来提供有关 JFC 组件的一些特定新方面的信息。

覆盖：

类 JComponent 中的 paramString

返回：

此 AbstractButton 的字符串表示形式