モジュール java.desktop

パッケージ javax.swing

クラスButtonGroup

java.lang.Object

javax.swing.ButtonGroup

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

Serializable

public class ButtonGroup extends Object implements Serializable

複数のボタンのセットに多重排他スコープを設定するために使用します。 同じButtonGroupオブジェクトを使用してボタンのセットを作成した場合、1つのボタンをオンにすると、グループに含まれるほかのボタンがすべてオフになります。

ButtonGroupは、AbstractButtonから継承するオブジェクト・セットで使用できます。 通常、ボタン・グループにはJRadioButton、JRadioButtonMenuItem、またはJToggleButtonのインスタンスが含まれています。 JButtonおよびJMenuItemは選択状態を実装しないため、ボタン・グループにJButtonまたはJMenuItemのインスタンスを含めるのはあまり意味がありません。

初期状態では、グループのボタンは1つも選択されていません。

ボタン・グループの使用例および詳細については、『The Java Tutorial』の「How to Use Radio Buttons」を参照してください。

警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。 現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。 1.4では、すべてのJavaBeansの長期ストレージのサポートがjava.beansパッケージに追加されました。 XMLEncoderを参照してください。

導入されたバージョン:

1.2

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
protected Vector<AbstractButton>	buttons	このグループに参加しているボタンのリスト。

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
ButtonGroup()	新しいButtonGroupを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	add(AbstractButton b)	グループにボタンを追加します。
void	clearSelection()	選択をクリアして、ButtonGroup内のボタンが1つも選択されていない状態にします。
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 - 削除するボタン

clearSelection

public void clearSelection()

選択をクリアして、ButtonGroup内のボタンが1つも選択されていない状態にします。

導入されたバージョン:

1.6

getElements

public Enumeration<AbstractButton> getElements()

このグループに参加するすべてのボタンを返します。

戻り値:

このグループのボタンのEnumeration

getSelection

public ButtonModel getSelection()

選択されたボタンのモデルを返します。

戻り値:

選択されたボタンのモデル

setSelected

public void setSelected(ButtonModel m, boolean b)

ButtonModelに対して選択された値を設定します。 一度に選択できるボタンはグループで1つだけです。

パラメータ:

m - ButtonModel

b - ボタンが選択される場合はtrue、そうでない場合はfalse

isSelected

public boolean isSelected(ButtonModel m)

ButtonModelが選択されているかどうかを返します。

パラメータ:

m - ButtonModelのインスタンス

戻り値:

ボタンが選択されている場合はtrue、そうでない場合はfalse

getButtonCount

public int getButtonCount()

グループ内のボタンの数を返します。

戻り値:

ボタンの数

導入されたバージョン:

1.3