JavaTM 2 Platform
Standard Ed. 5.0

javax.swing
类 ButtonGroup

java.lang.Object
  继承者 javax.swing.ButtonGroup
所有已实现的接口:
Serializable

public class ButtonGroup
extends Object
implements Serializable

此类用于为一组按钮创建一个多斥(multiple-exclusion)作用域。使用相同的 ButtonGroup 对象创建一组按钮意味着“开启”其中一个按钮时,将关闭组中的其他所有按钮。

可将 ButtonGroup 用于任何从 AbstractButton 继承的对象组。通常,按钮组包含 JRadioButtonJRadioButtonMenuItemJToggleButton 的实例。但将 JButtonJMenuItem 的实例放入按钮组中并没有什么意义,因为 JButtonJMenuItem 不实现选择状态。

最初,组中的所有按钮都未被选择。一旦选择了任何按钮,该按钮在组中将总是选择状态。无法以编程方式“关闭”一个按钮以清除按钮组。要显示“未选择”的按钮,则需要将一个不可见的单选钮添加到组中,然后以编程方式选择该按钮,以关闭所有已显示的单选钮。例如,可以激活带标签 "none" 的普通按钮来选择不可见的单选钮。

有关使用按钮组的示例和更多信息,请参阅《The Java Tutorial》中的 How to Radio Buttons 一节。

警告:此类的已序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储,或适用于在运行相同 Swing 版本的应用程序之间进行 RMI(Remote Method Invocation,远程方法调用)。从 1.4 版本开始,已在 java.beans 包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 XMLEncoder


字段摘要
protected  Vector<AbstractButton> buttons
           
 
构造方法摘要
ButtonGroup()
          创建一个新的 ButtonGroup
 
方法摘要
 void add(AbstractButton b)
          将按钮添加到组中。
 int getButtonCount()
          返回组中的按钮数。
 Enumeration<AbstractButton> getElements()
          返回此按钮组中的所有按钮。
 ButtonModel getSelection()
          返回选择按钮的模型。
 boolean isSelected(ButtonModel m)
          返回对是否已选择一个 ButtonModel 的判断。
 void remove(AbstractButton b)
          从组中移除按钮。
 void setSelected(ButtonModel m, boolean b)
          为 ButtonModel 设置选择值。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

字段详细信息

buttons

protected Vector<AbstractButton> buttons
构造方法详细信息

ButtonGroup

public ButtonGroup()
创建一个新的 ButtonGroup

方法详细信息

add

public void add(AbstractButton b)
将按钮添加到组中。

参数:
b - 要添加的按钮

remove

public void remove(AbstractButton b)
从组中移除按钮。

参数:
b - 要移除的按钮

getElements

public Enumeration<AbstractButton> getElements()
返回此按钮组中的所有按钮。

返回:
此组中的按钮的 Enumeration

getSelection

public ButtonModel getSelection()
返回选择按钮的模型。

返回:
选择的按钮模型

setSelected

public void setSelected(ButtonModel m,
                        boolean b)
ButtonModel 设置选择值。一次只能选择组中的一个按钮。

参数:
m - ButtonModel
b - 如果此按钮被选择,则该参数为 true,否则为 false

isSelected

public boolean isSelected(ButtonModel m)
返回对是否已选择一个 ButtonModel 的判断。

返回:
如果选择了按钮,则返回 true;否则返回 false

getButtonCount

public int getButtonCount()
返回组中的按钮数。

返回:
按钮计数
从以下版本开始:
1.3

JavaTM 2 Platform
Standard Ed. 5.0

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

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