モジュール java.desktop
パッケージ javax.swing

クラスButtonGroup

java.lang.Object
javax.swing.ButtonGroup
すべての実装されたインタフェース:
Serializable

public class ButtonGroup extends Object implements Serializable
複数のボタンのセットに多重排他スコープを設定するために使用します。 同じButtonGroupオブジェクトを使用してボタンのセットを作成した場合、1つのボタンをオンにすると、グループに含まれるほかのボタンがすべてオフになります。

ButtonGroupは、AbstractButtonから継承するオブジェクト・セットで使用できます。 通常、ボタン・グループにはJRadioButtonJRadioButtonMenuItem、または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