Java javax.swing 接口 ButtonModel（JDK5）

141 阅读 0 评论 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 表示取消对按钮的选择。