JavaTM 2 Platform
Standard Ed. 5.0

java.awt
类 CheckboxGroup

java.lang.Object
  继承者 java.awt.CheckboxGroup
所有已实现的接口:
Serializable

public class CheckboxGroup
extends Object
implements Serializable

CheckboxGroup 类用于对 Checkbox 集合进行分组。

准确地说,CheckboxGroup 中的复选框按钮可以在任意给定的时间为 "on"。按下任何按钮,可将按钮状态设置为 "on",并且强制将任何其他 "on" 状态的按钮更改为 "off" 状态。

以下代码示例生成了一个新的复选框组,其中有三个复选框:


 setLayout(new GridLayout(3, 1));
 CheckboxGroup cbg = new CheckboxGroup();
 add(new Checkbox("one", cbg, true));
 add(new Checkbox("two", cbg, false));
 add(new Checkbox("three", cbg, false));
 

下面的图像描绘了此示例创建的复选框组:

按垂直排列方式显示三个复选框,其标签分别为 one、two、three。复选框 one 处于 on 状态。

从以下版本开始:
JDK1.0
另请参见:
Checkbox, 序列化表格

构造方法摘要
CheckboxGroup()
          创建 CheckboxGroup 的一个新实例。
 
方法摘要
 Checkbox getCurrent()
          已过时。 从 JDK version 1.1 开始,由 getSelectedCheckbox() 取代。
 Checkbox getSelectedCheckbox()
          从此复选框组中获得当前选择。
 void setCurrent(Checkbox box)
          已过时。 从 JDK version 1.1 开始,由 setSelectedCheckbox(Checkbox) 取代。
 void setSelectedCheckbox(Checkbox box)
          将此组中当前选中的复选框设置为指定的复选框。
 String toString()
          返回此复选框组的字符串表示形式,包含当前选中复选框的值。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

CheckboxGroup

public CheckboxGroup()
创建 CheckboxGroup 的一个新实例。

方法详细信息

getSelectedCheckbox

public Checkbox getSelectedCheckbox()
从此复选框组中获得当前选择。当前选择就是此组中当前处于 "on" 状态的复选框,如果组中所有复选框都处于 off 状态,则返回 null

返回:
当前处于 "on" 状态的复选框,或者返回 null
从以下版本开始:
JDK1.1
另请参见:
Checkbox, setSelectedCheckbox(java.awt.Checkbox)

getCurrent

@Deprecated
public Checkbox getCurrent()
已过时。 从 JDK version 1.1 开始,由 getSelectedCheckbox() 取代。


setSelectedCheckbox

public void setSelectedCheckbox(Checkbox box)
将此组中当前选中的复选框设置为指定的复选框。此方法将该复选框的状态设置为 "on",并将组中所有其他复选框设置为 off。

如果复选框参数为 null,则此复选框组中的所有复选框都会被取消选中。如果复选框参数属于一个不同的复选框组,则此方法不执行任何操作。

参数:
box - 要设置为当前选中复选框的 Checkbox
从以下版本开始:
JDK1.1
另请参见:
Checkbox, getSelectedCheckbox()

setCurrent

@Deprecated
public void setCurrent(Checkbox box)
已过时。 从 JDK version 1.1 开始,由 setSelectedCheckbox(Checkbox) 取代。


toString

public String toString()
返回此复选框组的字符串表示形式,包含当前选中复选框的值。

覆盖:
Object 中的 toString
返回:
此复选框组的字符串表示形式。

JavaTM 2 Platform
Standard Ed. 5.0

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

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