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^TM 用の長期間の格納サポートが java.beans パッケージに追加されています。XMLEncoder を参照してください。

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
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 が選択されているかどうかを返します。

戻り値:

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

getButtonCount

public int getButtonCount()

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

戻り値:

ボタンの数

導入されたバージョン:

1.3