DefaultButtonModel

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.swing
类 DefaultButtonModel

java.lang.Object
  javax.swing.DefaultButtonModel

所有已实现的接口：: ItemSelectable, Serializable, ButtonModel

直接已知子类：: JToggleButton.ToggleButtonModel

public class DefaultButtonModel
extends Object
implements ButtonModel, Serializable

Button 组件的数据模型的默认实现。

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

字段摘要
`protected String`	`actionCommand` 按钮所触发的动作命令字符串。
`static int`	`ARMED` 标识位掩码中“选中的”位，该位指示选择/触发按钮操作的部分委托事项。
`protected ChangeEvent`	`changeEvent` 每个按钮模型实例只需要一个 `ChangeEvent`，因为事件的唯一状态是源属性。
`static int`	`ENABLED` 标识位掩码中“启用的”位，该位指示可以通过输入设备（如鼠标指针）选择按钮。
`protected ButtonGroup`	`group` 按钮所属的按钮组。
`protected EventListenerList`	`listenerList` 在此模型中存储侦听器。
`protected int`	`mnemonic` 按钮的助记符。
`static int`	`PRESSED` 标识位掩码中“按下的”位，该位指示按钮已经被按下。
`static int`	`ROLLOVER` 标识位掩码中“翻转的”位，该位指示鼠标位于按钮上。
`static int`	`SELECTED` 标识位掩码中“选定的”位，该位指示按纽已被选定。
`protected int`	`stateMask` 用于存储按钮状态的位掩码。

构造方法摘要
`DefaultButtonModel()` 构造一个 `DefaultButtonModel`。

方法摘要

void addActionListener(ActionListener l)
向模型添加一个 ActionListener。

void addChangeListener(ChangeListener l)
向模型添加一个 ChangeListener。

void addItemListener(ItemListener l)
向模型添加一个 ItemListener。

protected void fireActionPerformed(ActionEvent e)
通知所有对此事件类型的通知感兴趣的已注册侦听器。

protected void fireItemStateChanged(ItemEvent e)
通知所有对此事件类型的通知感兴趣的已注册侦听器。

protected void fireStateChanged()
通知所有对此事件类型的通知感兴趣的已注册侦听器。

String getActionCommand()
返回该按钮的动作命令字符串。

ActionListener[] getActionListeners()
返回此 DefaultButtonModel 上所有已注册的操作侦听器组成的数组。

ChangeListener[] getChangeListeners()
返回此 DefaultButtonModel 上所有已注册的更改侦听器组成的数组。

ButtonGroup getGroup()
返回该按钮所属的组。

ItemListener[] getItemListeners()
返回此 DefaultButtonModel 上所有已注册的项侦听器组成的数组。




<T extends EventListener> 


T[]

getListeners(Class<T> listenerType)
返回目前已在此模型上注册为 FooListener 的所有对象组成的数组。

int getMnemonic()
获取该按钮的键盘助记符。

Object[] getSelectedObjects()
重写以返回 null。

boolean isArmed()
指示触发按钮操作的部分委托事项。

boolean isEnabled()
指示是否可通过输入设备（比如鼠标指针）选择或触发按钮。

boolean isPressed()
指示按钮是否已被按下。

boolean isRollover()
指示鼠标是否在按钮上。

boolean isSelected()
指示按钮是否已经被选择。

void removeActionListener(ActionListener l)
从模型中移除一个 ActionListener。

void removeChangeListener(ChangeListener l)
从模型中移除一个 ChangeListener。

void removeItemListener(ItemListener l)
从模型中移除一个 ItemListener。

void setActionCommand(String actionCommand)
设置动作命令字符串，在触发按钮时，该字符串将作为 ActionEvent 的一部分被发送。

void setArmed(boolean b)
将此按钮标记为选中或未选中。

void setEnabled(boolean b)
启用或禁用该按钮。

void setGroup(ButtonGroup group)
标识该按钮所属的组，这是单选钮所需要的，单选钮在它们的组内相互排斥。

void setMnemonic(int key)
设置该按钮的键盘助记符（快捷键或加速键）。

void setPressed(boolean b)
将按钮设置为按下或未被按下。

void setRollover(boolean b)
设置或清除该按钮的翻转状态

void setSelected(boolean b)
选择或取消选择该按钮。

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

字段详细信息

stateMask

protected int stateMask

用于存储按钮状态的位掩码。

actionCommand

protected String actionCommand

按钮所触发的动作命令字符串。

group

protected ButtonGroup group

按钮所属的按钮组。

mnemonic

protected int mnemonic

按钮的助记符。

changeEvent

protected transient ChangeEvent changeEvent

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

listenerList

protected EventListenerList listenerList

在此模型中存储侦听器。

ARMED

public static final int ARMED

标识位掩码中“选中的”位，该位指示选择/触发按钮操作的部分委托事项。

另请参见：: 常量字段值

SELECTED

public static final int SELECTED

标识位掩码中“选定的”位，该位指示按纽已被选定。只有某些类型的按钮需要该指示，比如单选钮或复选框。

另请参见：: 常量字段值

PRESSED

public static final int PRESSED

标识位掩码中“按下的”位，该位指示按钮已经被按下。

另请参见：: 常量字段值

ENABLED

public static final int ENABLED

标识位掩码中“启用的”位，该位指示可以通过输入设备（如鼠标指针）选择按钮。

另请参见：: 常量字段值

ROLLOVER

public static final int ROLLOVER

标识位掩码中“翻转的”位，该位指示鼠标位于按钮上。

另请参见：: 常量字段值

构造方法详细信息

public DefaultButtonModel()

构造一个 DefaultButtonModel。

方法详细信息

setActionCommand

public void setActionCommand(String actionCommand)

设置动作命令字符串，在触发按钮时，该字符串将作为 ActionEvent 的一部分被发送。

指定者：: 接口 ButtonModel 中的 setActionCommand

参数：: actionCommand - 标识生成的事件的 String
另请参见：: ButtonModel.getActionCommand(), ActionEvent.getActionCommand()

getActionCommand

public String getActionCommand()

返回该按钮的动作命令字符串。

指定者：: 接口 ButtonModel 中的 getActionCommand

返回：: 标识生成的事件的 String
另请参见：: ButtonModel.setActionCommand(java.lang.String)

isArmed

public boolean isArmed()

指示触发按钮操作的部分委托事项。

指定者：: 接口 ButtonModel 中的 isArmed

返回：: 如果按钮被选中，并准备触发它，则返回 true
另请参见：: ButtonModel.setArmed(boolean)

isSelected

public boolean isSelected()

指示按钮是否已经被选择。只有某些类型的按钮需要此指示，比如单选钮和复选框。

指定者：: 接口 ButtonModel 中的 isSelected

返回：: 如果按钮已选择，则返回 true

isEnabled

public boolean isEnabled()

指示是否可通过输入设备（比如鼠标指针）选择或触发按钮。

指定者：: 接口 ButtonModel 中的 isEnabled

返回：: 如果启用按钮，则返回 true

isPressed

public boolean isPressed()

指示按钮是否已被按下。

指定者：: 接口 ButtonModel 中的 isPressed

返回：: 如果按钮已被按下，则返回 true

isRollover

public boolean isRollover()

指示鼠标是否在按钮上。

指定者：: 接口 ButtonModel 中的 isRollover

返回：: 如果鼠标在按钮上，则返回 true

setArmed

public void setArmed(boolean b)

将此按钮标记为选中或未选中。

指定者：: 接口 ButtonModel 中的 setArmed

参数：: b - 是否应该选中该按钮

setEnabled

public void setEnabled(boolean b)

启用或禁用该按钮。

指定者：: 接口 ButtonModel 中的 setEnabled

参数：: b - 是否应该启用该按钮
另请参见：: ButtonModel.isEnabled()

setSelected

public void setSelected(boolean b)

选择或取消选择该按钮。

指定者：: 接口 ButtonModel 中的 setSelected

参数：: b - 为 true 表示选择该按钮，为 false 表示取消对该按钮的选择。

setPressed

public void setPressed(boolean b)

将按钮设置为按下或未被按下。

指定者：: 接口 ButtonModel 中的 setPressed

参数：: b - 是否应该按下该按钮
另请参见：: ButtonModel.isPressed()

setRollover

public void setRollover(boolean b)

设置或清除该按钮的翻转状态

指定者：: 接口 ButtonModel 中的 setRollover

参数：: b - 该按钮是否处于翻转状态
另请参见：: ButtonModel.isRollover()

setMnemonic

public void setMnemonic(int key)

设置该按钮的键盘助记符（快捷键或加速键）。

指定者：: 接口 ButtonModel 中的 setMnemonic

参数：: key - 指示加速键的 int 值

getMnemonic

public int getMnemonic()

获取该按钮的键盘助记符。

指定者：: 接口 ButtonModel 中的 getMnemonic

返回：: 指示加速键的 int 值
另请参见：: ButtonModel.setMnemonic(int)

addChangeListener

public void addChangeListener(ChangeListener l)

向模型添加一个 ChangeListener。

指定者：: 接口 ButtonModel 中的 addChangeListener

参数：: l - 要添加的侦听器

removeChangeListener

public void removeChangeListener(ChangeListener l)

从模型中移除一个 ChangeListener。

指定者：: 接口 ButtonModel 中的 removeChangeListener

参数：: l - 要移除的侦听器

getChangeListeners

public ChangeListener[] getChangeListeners()

返回此 DefaultButtonModel 上所有已注册的更改侦听器组成的数组。

返回：: 此模型的所有 ChangeListener，如果当前没有已注册的更改侦听器，则返回一个空数组。
从以下版本开始：: 1.4
另请参见：: addChangeListener(javax.swing.event.ChangeListener), removeChangeListener(javax.swing.event.ChangeListener)

fireStateChanged

protected void fireStateChanged()

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

另请参见：: EventListenerList

addActionListener

public void addActionListener(ActionListener l)

向模型添加一个 ActionListener。

指定者：: 接口 ButtonModel 中的 addActionListener

参数：: l - 要添加的侦听器

removeActionListener

public void removeActionListener(ActionListener l)

从模型中移除一个 ActionListener。

指定者：: 接口 ButtonModel 中的 removeActionListener

参数：: l - 要移除的侦听器

getActionListeners

public ActionListener[] getActionListeners()

返回此 DefaultButtonModel 上所有已注册的操作侦听器组成的数组。

返回：: 此模型的所有 ActionListener；如果当前没有注册任何操作侦听器，则返回一个空数组。
从以下版本开始：: 1.4
另请参见：: addActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener)

fireActionPerformed

protected void fireActionPerformed(ActionEvent e)

通知所有对此事件类型的通知感兴趣的已注册侦听器。

参数：: e - 要传递给侦听器的 ActionEvent
另请参见：: EventListenerList

addItemListener

public void addItemListener(ItemListener l)

向模型添加一个 ItemListener。

指定者：: 接口 ItemSelectable 中的 addItemListener
指定者：: 接口 ButtonModel 中的 addItemListener

参数：: l - 要添加的侦听器
另请参见：: ItemEvent

removeItemListener

public void removeItemListener(ItemListener l)

从模型中移除一个 ItemListener。

指定者：: 接口 ItemSelectable 中的 removeItemListener
指定者：: 接口 ButtonModel 中的 removeItemListener

参数：: l - 要移除的侦听器
另请参见：: ItemEvent

getItemListeners

public ItemListener[] getItemListeners()

返回此 DefaultButtonModel 上所有已注册的项侦听器组成的数组。

返回：: 此模型的所有 ItemListener，如果没有当前已注册的项侦听器，则返回一个空数组
从以下版本开始：: 1.4
另请参见：: addItemListener(java.awt.event.ItemListener), removeItemListener(java.awt.event.ItemListener)

fireItemStateChanged

protected void fireItemStateChanged(ItemEvent e)

通知所有对此事件类型的通知感兴趣的已注册侦听器。

参数：: e - 要传递给侦听器的 ItemEvent
另请参见：: EventListenerList

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

返回目前已在此模型上注册为 FooListener 的所有对象组成的数组。FooListener 是用 addFooListener 方法注册的。

可以使用 class 字面值来指定 listenerType 参数，如 FooListener.class。例如，可以使用下面的代码查询 DefaultButtonModel 实例 m 的操作侦听器：

ActionListener[] als = (ActionListener[])(m.getListeners(ActionListener.class));

如果不存在这样的侦听器，则此方法将返回一个空数组。

参数：: listenerType - 请求的侦听器类型；该参数应该指定一个从 java.util.EventListener 继承的接口
返回：: 在此模型上注册为 FooListener 的所有对象组成的数组，如果没有添加这样的侦听器，则返回一个空数组
抛出：: ClassCastException - 如果 listenerType 没有指定实现 java.util.EventListener 的类或接口
从以下版本开始：: 1.3
另请参见：: getActionListeners(), getChangeListeners(), getItemListeners()

getSelectedObjects

public Object[] getSelectedObjects()

重写以返回 null。

指定者：: 接口 ItemSelectable 中的 getSelectedObjects

setGroup

public void setGroup(ButtonGroup group)

标识该按钮所属的组，这是单选钮所需要的，单选钮在它们的组内相互排斥。

指定者：: 接口 ButtonModel 中的 setGroup

参数：: group - 该按钮所属的 ButtonGroup

getGroup

public ButtonGroup getGroup()

返回该按钮所属的组。通常用于单选钮，它们在其组中相互排斥。

返回：: 该按钮所属的 ButtonGroup
从以下版本开始：: 1.3

概述