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

クラスCheckboxGroup

java.lang.Object
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()
    現在の選択の値を示す、このチェックボックス・グループの文字列表現を返します。

    クラス java.lang.Objectで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

  • コンストラクタの詳細

    • 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

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

    • toString

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