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 つも選択されていません。一度どれかが選択されると、そのグループでは 1 つのボタンが常に選択されています。ボタンをプログラム処理でオフにし、ボタングループを初期化する方法はありません。1 つも選択されていない状態を実現するには、不可視のラジオボタンをグループに追加して、このボタンですべてのラジオボタン (表示されているもの) をオフにできるようプログラム的に選択します。たとえば、「none」というラベルの付いた通常のボタンに、この不可視のラジオボタンを選択する機能をプログラム (実装) したりします。

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

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。

関連項目:

直列化された形式

フィールドの概要

protected Vector

buttons

コンストラクタの概要

ButtonGroup()
新しい ButtonGroup を作成します。

メソッドの概要

void	add(AbstractButton b) グループにボタンを追加します。
int	getButtonCount() グループ内のボタンの数を返します。
Enumeration	getElements() グループに関連するすべてのボタンを返します。
ButtonModel	getSelection() 選択されたボタンのモデルを返します。
boolean	isSelected(ButtonModel m) ボタンに選択された値を返します。
void	remove(AbstractButton b) グループからボタンを削除します。
void	setSelected(ButtonModel m, boolean b) ボタンに選択された値を設定します。

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

buttons

protected Vector buttons

コンストラクタの詳細

ButtonGroup

public ButtonGroup()

新しい ButtonGroup を作成します。

メソッドの詳細

add

public void add(AbstractButton b)

グループにボタンを追加します。

remove

public void remove(AbstractButton b)

グループからボタンを削除します。

getElements

public Enumeration getElements()

グループに関連するすべてのボタンを返します。

getSelection

public ButtonModel getSelection()

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

setSelected

public void setSelected(ButtonModel m,
                        boolean b)

ボタンに選択された値を設定します。

isSelected

public boolean isSelected(ButtonModel m)

ボタンに選択された値を返します。

getButtonCount

public int getButtonCount()

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