クラス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に対して選択された値を設定します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • フィールド詳細

    • 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