javax.swing.AbstractButton - 定义按钮和菜单项的一般行为。

javax.swing

接口

类

异常

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
extends JComponent
implements ItemSelectable, SwingConstants

定义按钮和菜单项的一般行为。

按钮可以进行配置，以及通过 Action 进行某种程度的控制。使用带有按钮的 Action 具有除直接配置按钮之外的许多优点。有关更多信息，请参阅支持 Action 的 Swing 组件，在 The Java Tutorial 中的 How to Use Actions 一节中可以找到更多信息。

有关更多信息，请参阅 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.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy`

字段摘要
`protected ActionListener`	`actionListener` 按钮模型的 `ActionListener`。
`static String`	`BORDER_PAINTED_CHANGED_PROPERTY` 标识是否绘制边框的更改。
`protected ChangeEvent`	`changeEvent` 每个按钮实例都只需要一个 `ChangeEvent`，因为事件的唯一状态是源属性。
`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()`

方法摘要
`protected void`	`actionPropertyChanged(Action action, String propertyName)` 更新按钮的状态以响应相关的操作中的属性更改。
`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` 添加到 `checkbox` 中。
`protected int`	`checkHorizontalKey(int key, String exception)` 验证 `key` 参数是否为 `horizontalAlignment` 和 `horizontalTextPosition` 属性的合法值。
`protected int`	`checkVerticalKey(int key, String exception)` 验证 `key` 参数是否为垂直属性的合法值。
`protected void`	`configurePropertiesFromAction(Action a)` 在此按钮上设置属性以匹配指定 `Action` 中的属性。
`protected ActionListener`	`createActionListener()`
`protected PropertyChangeListener`	`createActionPropertyChangeListener(Action a)` 创建并返回 `PropertyChangeListener`，它负责侦听指定 `Action` 的更改以及更新适当的属性。
`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()` 以索引形式返回字符，它表示助记符字符，外观应该对其提供装饰。
`boolean`	`getHideActionText()` 返回 `hideActionText` 属性的值，该属性确定按钮是否显示 `Action` 的文本。
`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`	`removeNotify()` 通知此组件它不再有父组件。
`void`	`setAction(Action a)` 设置 `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`	`setHideActionText(boolean hideActionText)` 设置 `hideActionText` 属性，该属性确定按钮是否显示 `Action` 的文本。
`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( JDK 1.6 中文手册`

javax.swing

接口

类

异常

javax.swing 类 AbstractButton

javax.swing
类 AbstractButton