java.awt
クラス CheckboxGroup

java.lang.Object
  |
  +--java.awt.CheckboxGroup

すべての実装インタフェース:

Serializable

public class CheckboxGroup

extends Object

implements Serializable

CheckboxGroup クラスは Checkbox ボタンのグループ化に使用します。

CheckboxGroup 内で一度に「オン」の状態にすることができるのは 1 つのチェックボックスボタンだけです。1 つのボタンを押して「オン」の状態にすると、「オン」の状態だったほかのボタンは「オフ」の状態になります。

次のコード例では、3 つのチェックボックスからなる新しいチェックボックスグループを作成します。

 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 バージョン 1.1 以降では getSelectedCheckbox() を使用
Checkbox	getSelectedCheckbox() このチェックボックスグループでの現在の選択を返します。
void	setCurrent(Checkbox box) 推奨されていません。 JDK バージョン 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()

このチェックボックスグループでの現在の選択を返します。現在の選択は、このグループ内で現在「オン」の状態であるチェックボックスです。グループ内のすべてのチェックボックスが「オフ」になっている場合は null を返します。

戻り値:

現在「オン」の状態であるチェックボックス、または null

導入されたバージョン:

JDK1.1

関連項目:

Checkbox, setSelectedCheckbox(java.awt.Checkbox)

getCurrent

public Checkbox getCurrent()

推奨されていません。 JDK バージョン 1.1 以降では getSelectedCheckbox() を使用

setSelectedCheckbox

public void setSelectedCheckbox(Checkbox box)

現在このグループ内で選択されているチェックボックスを、指定されたチェックボックスに設定します。このメソッドはそのチェックボックスの状態を「オン」に設定し、グループ内のほかのすべてのチェックボックスをオフに設定します。

チェックボックス引数が null の場合、このチェックボックスグループのチェックボックスはすべて選択解除されます。チェックボックス引数がほかのチェックボックスグループに属する場合、このメソッドは何も処理しません。

パラメータ:

box - 現在の選択として設定する Checkbox

導入されたバージョン:

JDK1.1

関連項目:

Checkbox, getSelectedCheckbox()

setCurrent

public void setCurrent(Checkbox box)

推奨されていません。 JDK バージョン 1.1 以降では setSelectedCheckbox(Checkbox) を使用

toString

public String toString()

現在の選択状態の値を示す、このチェックボックスグループの文字列表現を返します。

オーバーライド:

クラス Object 内の toString

戻り値:

このチェックボックスグループの文字列表現