Module java.desktop
Package java.awt

Class CheckboxGroup

java.lang.Object
java.awt.CheckboxGroup
所有已实现的接口:
Serializable
public class CheckboxGroup extends Object implements Serializable
CheckboxGroup类用于将一组Checkbox按钮分组。

CheckboxGroup中的一个复选框按钮可以处于“开”状态，任何时候只能有一个按钮处于“开”状态。按下任何按钮会将其状态设置为“开”，并将任何其他处于“开”状态的按钮强制设置为“关”状态。

以下代码示例生成一个新的复选框组，其中包含三个复选框：

 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));

此图像描述了此示例创建的复选框组：

显示三个垂直排列的复选框，标记为one、two和three。复选框one处于开启状态。

自版本:
1.0
参见:

  • Constructor Details

    • CheckboxGroup

      public CheckboxGroup()
      创建一个新的CheckboxGroup实例。

  • Method Details

    • getSelectedCheckbox

      public Checkbox getSelectedCheckbox()
      获取此复选框组的当前选择。当前选择是该组中当前处于“开”状态的复选框，如果组中所有复选框都处于关闭状态，则返回null。
      返回:
      当前处于“开”状态的复选框，或null。
      自版本:
      1.1
      参见:

    • getCurrent

      @Deprecated public Checkbox getCurrent()
      Deprecated.
      As of JDK version 1.1, replaced by getSelectedCheckbox().
      返回此复选框组的当前选择，如果没有复选框被选中，则返回null。
      返回:
      选定的复选框

    • setSelectedCheckbox

      public void setSelectedCheckbox(Checkbox box)
      将此组中当前选定的复选框设置为指定的复选框。此方法将该复选框的状态设置为“开”，并将组中的所有其他复选框设置为“关”。

      如果复选框参数为null，则取消选择此复选框组中的所有复选框。如果复选框参数属于不同的复选框组，则此方法不执行任何操作。

      参数:
      box - 要设置为当前选择的Checkbox。
      自版本:
      1.1
      参见:

    • setCurrent

      @Deprecated public void setCurrent(Checkbox box)
      Deprecated.
      As of JDK version 1.1, replaced by setSelectedCheckbox(Checkbox).
      将此组中当前选定的复选框设置为指定的复选框，并取消所有其他复选框的选择。
      参数:
      box - 要设置为当前选择的Checkbox。

    • toString

      public String toString()
      返回此复选框组的字符串表示，包括其当前选择的值。
      覆盖:
      toString 在类 Object
      返回:
      此复选框组的字符串表示。