- 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
に対して選択された値を設定します。
-
-
-
フィールドの詳細
-
buttons
protected Vector<AbstractButton> buttons
このグループに参加しているボタンのリスト。
-
-
メソッドの詳細
-
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
-
-