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));
 

下面的圖像描繪了此範例創建的複選框組：

從以下版本開始：

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

返回：

此複選框組的字元串表示形式。