モジュール java.desktop
パッケージ java.awt

クラスCheckboxGroup

  • すべての実装されたインタフェース:
    Serializable

    public class CheckboxGroup
    extends Object
    implements Serializable
    CheckboxGroupクラスは、Checkboxボタンのセットをグループ化するために使用されます。

    CheckboxGroup内で一度にオンの状態にすることができるのは1つのチェックボックス・ボタンだけです。 1つのボタンを押してオンの状態にすると、オンの状態だったほかのボタンはオフの状態になります。

    次のコード例では、3つのチェックボックスからなる新しいチェックボックス・グループを作成します。


     setLayout(new GridLayout(3, 1));
     CheckboxGroup cbg = new CheckboxGroup();
     add(new Checkbox("one", cbg, true));
     add(new Checkbox("two", cbg, false));
     add(new Checkbox("three", cbg, false));
     

    次のイメージは、この例によって作成されるチェックボックス・グループを表します。

    垂直に並べられ、1、2、3とラベル付けされたチェックボックスを示す。 チェックボックス1はオン状態

    導入されたバージョン:
    1.0
    関連項目:
    Checkbox, 直列化された形式
    • コンストラクタのサマリー

      コンストラクタ 
      コンストラクタ 説明
      CheckboxGroup()
      CheckboxGroupの新しいインスタンスを作成します。
    • メソッドのサマリー

      修飾子と型 メソッド 説明
      Checkbox getCurrent()
      非推奨。
      JDK Version 1.1以降は、getSelectedCheckbox()に置き換えられています。
      Checkbox getSelectedCheckbox()
      このチェックボックス・グループから現在の選択を取得します。
      void setCurrent​(Checkbox box)
      非推奨。
      JDK Version 1.1以降は、setSelectedCheckbox(Checkbox)に置き換えられています。
      void setSelectedCheckbox​(Checkbox box)
      このグループ内で現在選択されているチェックボックスを、指定されたチェックボックスに設定します。
      String toString()
      現在の選択の値を示す、このチェックボックス・グループの文字列表現を返します。
    • コンストラクタの詳細

      • CheckboxGroup

        public CheckboxGroup()
        CheckboxGroupの新しいインスタンスを作成します。
    • メソッドの詳細

      • getSelectedCheckbox

        public Checkbox getSelectedCheckbox()
        このチェックボックス・グループから現在の選択を取得します。 現在の選択は、このグループ内で現在オンの状態であるチェックボックスです。グループ内のすべてのチェックボックスがオフになっている場合はnullを返します。
        戻り値:
        現在オンの状態であるチェックボックス、またはnull
        導入されたバージョン:
        1.1
        関連項目:
        Checkbox, setSelectedCheckbox(java.awt.Checkbox)
      • getCurrent

        @Deprecated
        public Checkbox getCurrent()
        非推奨。
        JDK Version 1.1以降は、getSelectedCheckbox()に置き換えられています。
        このチェックボックス・グループから現在の選択肢を返します。チェックボックスが1つも選択されていない場合はnullを返します。
        戻り値:
        選択されたチェックボックス
      • setSelectedCheckbox

        public void setSelectedCheckbox​(Checkbox box)
        このグループ内で現在選択されているチェックボックスを、指定されたチェックボックスに設定します。 このメソッドはそのチェックボックスの状態をオンに設定し、グループ内のほかのすべてのチェックボックスをオフに設定します。

        チェックボックス引数がnullの場合、このチェックボックス・グループのチェックボックスはすべて選択解除されます。 チェックボックス引数がほかのチェックボックス・グループに属する場合、このメソッドは何も処理しません。

        パラメータ:
        box - 現在の選択として設定するCheckbox
        導入されたバージョン:
        1.1
        関連項目:
        Checkbox, getSelectedCheckbox()
      • setCurrent

        @Deprecated
        public void setCurrent​(Checkbox box)
        非推奨。
        JDK Version 1.1以降は、setSelectedCheckbox(Checkbox)に置き換えられています。
        このグループの現在選択されているチェックボックスを指定されたチェックボックスに設定し、他のチェックボックスをすべて無効にします。
        パラメータ:
        box - 現在の選択として設定するCheckbox
      • toString

        public String toString()
        現在の選択の値を示す、このチェックボックス・グループの文字列表現を返します。
        オーバーライド:
        toString 、クラス:  Object
        戻り値:
        このチェックボックス・グループの文字列表現