モジュール java.desktop
パッケージ 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
    関連項目:
    直列化された形式

    • フィールドの詳細

      • 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