ButtonModel

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

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

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

javax.swing
接口 ButtonModel

所有超级接口：: ItemSelectable

所有已知实现类：: DefaultButtonModel, JToggleButton.ToggleButtonModel

public interface ButtonModel
extends ItemSelectable
extends ItemSelectable

按钮的状态模型。此模型用于复选框和单选钮，它们是特殊种类的按钮，也可以用于一些普通按钮。对于复选框和单选钮，可按下鼠标选择按钮。对于普通按钮，按下鼠标只是“装备” (arm) 该按钮。随后在按钮上释放鼠标时才启动一个按钮按下操作，触发其操作事件。在其他地方释放鼠标可解除对按钮的装备。

在使用中，当在复选框或单选钮上单击鼠标时，UI 将调用 setSelected(boolean)。当在常规按钮上按下鼠标时，UI 将调用 setArmed(boolean)，在释放鼠标时则调用 setPressed(boolean)。如果与此同时鼠标移动到按钮之外的地方，则 setArmed(false) 将告知该按钮在它看见 setPressed 时不要触发事件。（如果鼠标移回按钮内，则该按钮将被重新装备。）

注：
按钮在既被“装备”又被“按下”的时候才被触发。

方法摘要
`void`	`addActionListener(ActionListener l)` 向按钮添加一个 ActionListener。
`void`	`addChangeListener(ChangeListener l)` 向按钮添加一个 ChangeListener。
`void`	`addItemListener(ItemListener l)` 向按钮添加一个 ItemListener。
`String`	`getActionCommand()` 返回此按钮的动作命令。
`int`	`getMnemonic()` 获得此模型的键盘助记符
`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 s)` 设置 actionCommand 字符串，在按下按钮时，该字符串将作为事件的一部分被发送。
`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.awt.ItemSelectable 继承的方法
`getSelectedObjects`

方法详细信息

isArmed

boolean isArmed()

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

返回：: 如果按钮被装备，并准备按下它，则返回 true。
另请参见：: setArmed(boolean)

isSelected

boolean isSelected()

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

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

isEnabled

boolean isEnabled()

指示是否可通过输入设备（比如鼠标指针）选择或按下按钮。（复选框被选择，常规按钮被“按下”。）

返回：: 如果启用按钮，并且按钮因此而变为可选择的（或可按下的），则返回 true

isPressed

boolean isPressed()

指示按钮是否已被按下。

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

isRollover

boolean isRollover()

指示鼠标是否在按钮上。

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

setArmed

void setArmed(boolean b)

将此按钮标记为“装备”。如果释放鼠标按钮时，它位于此项上，则触发该按钮的操作事件。如果释放鼠标按钮时它在其他地方，则不会触发事件，并且该按钮被解除装备。

参数：: b - 为 true 表示要装备按钮，以便它可以被选择

setSelected

void setSelected(boolean b)

选择或取消选择按钮。

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

setEnabled

void setEnabled(boolean b)

启用或禁用按钮。

参数：: b - 为 true 表示启用按钮。
另请参见：: isEnabled()

setPressed

void setPressed(boolean b)

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

参数：: b - 为 true 表示将按钮设置为“按下”。
另请参见：: isEnabled()

setRollover

void setRollover(boolean b)

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

参数：: b - 为 true 表示开启翻转。
另请参见：: isRollover()

setMnemonic

void setMnemonic(int key)

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

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

getMnemonic

int getMnemonic()

获得此模型的键盘助记符

返回：: 指示加速器的 int 值。
另请参见：: setMnemonic(int)

setActionCommand

void setActionCommand(String s)

设置 actionCommand 字符串，在按下按钮时，该字符串将作为事件的一部分被发送。

参数：: s - 标识生成的事件的 String

getActionCommand

String getActionCommand()

返回此按钮的动作命令。

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

setGroup

void setGroup(ButtonGroup group)

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

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

addActionListener

void addActionListener(ActionListener l)

向按钮添加一个 ActionListener。

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

removeActionListener

void removeActionListener(ActionListener l)

从按钮中移除一个 ActionListener。

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

addItemListener

void addItemListener(ItemListener l)

向按钮添加一个 ItemListener。

指定者：: 接口 ItemSelectable 中的 addItemListener

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

removeItemListener

void removeItemListener(ItemListener l)

从按钮中移除一个 ItemListener。

指定者：: 接口 ItemSelectable 中的 removeItemListener

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

addChangeListener

void addChangeListener(ChangeListener l)

向按钮添加一个 ChangeListener。

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

removeChangeListener

void removeChangeListener(ChangeListener l)

从按钮中移除一个 ChangeListener。

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

概述