モジュール java.desktop
パッケージ 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の長期ストレージのサポートがjava.beansパッケージに追加されました。 XMLEncoderを参照してください。

導入されたバージョン:
1.2

  • フィールド詳細

    • ボタン

      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