CheckboxGroup (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

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

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

java.awt
类 CheckboxGroup

java.lang.Object
  java.awt.CheckboxGroup

所有已实现的接口：: Serializable

public class CheckboxGroup
extends Object
implements Serializable
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()` 创建 `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

返回：: 此复选框组的字符串表示形式。

概述