JavaTM 2 Platform
Standard Ed. 5.0

javax.swing
接口 ButtonModel

所有超级接口:
ItemSelectable
所有已知实现类:
DefaultButtonModel, JToggleButton.ToggleButtonModel

public interface ButtonModel
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 - 要移除的侦听器

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策