javax.swing

Class DefaultButtonModel

java.lang.Object

javax.swing.DefaultButtonModel

All Implemented Interfaces:

ItemSelectable ， Serializable ， ButtonModel

已知直接子类：

JToggleButton.ToggleButtonModel

public class DefaultButtonModel
extends Object
implements ButtonModel, Serializable

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

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

Field Summary

Fields

Modifier and Type	Field and Description
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 该位掩码用于存储按钮的状态。

构造方法摘要

构造方法

Constructor and Description
DefaultButtonModel() 构造一个 DefaultButtonModel 。

方法摘要

Modifier and Type	Method and Description
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上 DefaultButtonModel的所有动作侦听器的 DefaultButtonModel 。
ChangeListener[]	getChangeListeners() 返回在此 DefaultButtonModel上 DefaultButtonModel的所有更改监听器的 DefaultButtonModel 。
ButtonGroup	getGroup() 返回按钮所属的组。
ItemListener[]	getItemListeners() 返回在此 DefaultButtonModel上 DefaultButtonModel的所有项目侦听器的 DefaultButtonModel 。
<T extends EventListener> T[]	getListeners(类<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按钮时作为 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) 选择或取消选择按钮。

Methods inherited from class 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 ，因为事件的唯一状态是源属性。 生成的事件的来源总是“这”。

listenerList

protected EventListenerList listenerList

在这个模型上存储听众。

ARMED

public static final int ARMED

标识位掩码中的“布防”位，这表示部分承诺选择/触发按钮。

另请参见：

Constant Field Values

SELECTED

public static final int SELECTED

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

另请参见：

Constant Field Values

PRESSED

public static final int PRESSED

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

另请参见：

Constant Field Values

ENABLED

public static final int ENABLED

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

另请参见：

Constant Field Values

ROLLOVER

public static final int ROLLOVER

标识位掩码中的“翻转”位，表示鼠标在按钮上方。

另请参见：

Constant Field Values

构造方法详细信息

DefaultButtonModel

public DefaultButtonModel()

构造一个 DefaultButtonModel 。

方法详细信息

setActionCommand

public void setActionCommand(String actionCommand)

设置当 ActionEvent按钮时作为 ActionEvent一部分发送的动作命令字符串。

Specified by:

setActionCommand在接口 ButtonModel

参数

actionCommand - String生成的事件的String

另请参见：

ButtonModel.getActionCommand() ， ActionEvent.getActionCommand()

getActionCommand

public String getActionCommand()

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

Specified by:

getActionCommand在接口 ButtonModel

结果

String生成的事件的String

另请参见：

ButtonModel.setActionCommand(java.lang.String)

isArmed

public boolean isArmed()

表示部分承诺触发按钮。

Specified by:

isArmed在接口 ButtonModel

结果

true如果按钮被布防，并准备被触发

另请参见：

ButtonModel.setArmed(boolean)

isSelected

public boolean isSelected()

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

Specified by:

isSelected在接口 ButtonModel

结果

true如果选择按钮

isEnabled

public boolean isEnabled()

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

Specified by:

isEnabled在接口 ButtonModel

结果

true如果按钮被启用

isPressed

public boolean isPressed()

指示按下按钮。

Specified by:

isPressed在界面 ButtonModel

结果

true如果按下按钮

isRollover

public boolean isRollover()

表示鼠标在按钮上方。

Specified by:

isRollover在接口 ButtonModel

结果

true如果鼠标在按钮上方

setArmed

public void setArmed(boolean b)

将按钮标记为武装或非武装。

Specified by:

setArmed在接口 ButtonModel

参数

b - 是否应该按下按钮

setEnabled

public void setEnabled(boolean b)

启用或禁用按钮。

Specified by:

setEnabled在界面 ButtonModel

参数

b - 是否应启用按钮

另请参见：

ButtonModel.isEnabled()

setSelected

public void setSelected(boolean b)

选择或取消选择按钮。

Specified by:

setSelected在接口 ButtonModel

参数

b - true选择按钮， false取消选择按钮

setPressed

public void setPressed(boolean b)

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

Specified by:

setPressed在接口 ButtonModel

参数

b - 是否应按下按钮

另请参见：

ButtonModel.isPressed()

setRollover

public void setRollover(boolean b)

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

Specified by:

setRollover在接口 ButtonModel

参数

b - 按钮是否处于翻转状态

另请参见：

ButtonModel.isRollover()

setMnemonic

public void setMnemonic(int key)

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

Specified by:

setMnemonic在接口 ButtonModel

参数

key - 一个指定加速键的int

getMnemonic

public int getMnemonic()

获取按钮的键盘助记符。

Specified by:

getMnemonic中的 ButtonModel

结果

指定加速键的int

另请参见：

ButtonModel.setMnemonic(int)

addChangeListener

public void addChangeListener(ChangeListener l)

在模型中添加一个 ChangeListener 。

Specified by:

addChangeListener中的 ButtonModel

参数

l - 收听者添加

removeChangeListener

public void removeChangeListener(ChangeListener l)

从模型中移除 ChangeListener 。

Specified by:

removeChangeListener在界面 ButtonModel

参数

l - 要删除的侦听器

getChangeListeners

public ChangeListener[] getChangeListeners()

返回在此 DefaultButtonModel上 DefaultButtonModel的所有更改侦听器的 DefaultButtonModel 。

结果

所有这个模型的 ChangeListener s或一个空数组，如果没有更改监听器当前注册

从以下版本开始：

1.4

另请参见：

addChangeListener(javax.swing.event.ChangeListener) ， removeChangeListener(javax.swing.event.ChangeListener)

fireStateChanged

protected void fireStateChanged()

通知所有在此事件类型上通知有兴趣的听众。 事件实例是懒惰地创建的。

另请参见：

EventListenerList

addActionListener

public void addActionListener(ActionListener l)

在模型中添加一个 ActionListener 。

Specified by:

addActionListener在界面 ButtonModel

参数

l - 要添加的监听器

removeActionListener

public void removeActionListener(ActionListener l)

从模型中移除 ActionListener 。

Specified by:

removeActionListener在界面 ButtonModel

参数

l - 要删除的侦听器

getActionListeners

public ActionListener[] getActionListeners()

返回在此 DefaultButtonModel上 DefaultButtonModel的所有动作侦听器的 DefaultButtonModel 。

结果

所有这个模型的 ActionListener s或一个空数组，如果没有动作侦听器当前注册

从以下版本开始：

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 。

Specified by:

addItemListener在界面 ItemSelectable

Specified by:

addItemListener在界面 ButtonModel

参数

l - 要添加的收听者

另请参见：

ItemEvent

removeItemListener

public void removeItemListener(ItemListener l)

从模型中删除 ItemListener 。

Specified by:

removeItemListener在界面 ItemSelectable

Specified by:

removeItemListener在界面 ButtonModel

参数

l - 要删除的侦听器

另请参见：

ItemEvent

getItemListeners

public ItemListener[] getItemListeners()

返回在此 DefaultButtonModel上 DefaultButtonModel的所有项目侦听器的 DefaultButtonModel 。

结果

所有这个模型的 ItemListener s或一个空数组，如果没有项目监听器当前注册

从以下版本开始：

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(类<T> listenerType)

返回此模型上当前注册为FooListener的所有对象的数组。 FooListener使用addFooListener 。

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

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

如果没有这样的侦听器存在，这个方法返回一个空数组。

参数

listenerType - 所请求的听众的类型; 此参数应指定从java.util.EventListener下降的java.util.EventListener

结果

在该模型上注册为 FooListener的所有对象的数组，如果没有添加这样的侦听器，则为空数组

异常

ClassCastException - 如果 listenerType没有指定实现java.util.EventListener的类或 java.util.EventListener

从以下版本开始：

1.3

另请参见：

getActionListeners() ， getChangeListeners() ， getItemListeners()

getSelectedObjects

public Object[] getSelectedObjects()

被覆盖返回 null 。

Specified by:

getSelectedObjects在接口 ItemSelectable

setGroup

public void setGroup(ButtonGroup group)

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

Specified by:

setGroup在界面 ButtonModel

参数

group - 该按钮属于 ButtonGroup

getGroup

public ButtonGroup getGroup()

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

结果

按钮所属的 ButtonGroup

从以下版本开始：

1.3