Module  java.desktop
软件包  java.awt

Class CheckboxGroup

  • All Implemented Interfaces:
    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));

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

    显示三个复选框，垂直排列，标记为一，二和三。复选框1处于开状态。

    从以下版本开始：
    1.0
    另请参见：
    Checkbox ， Serialized Form

    • 构造方法详细信息

      • CheckboxGroup

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

    • 方法详细信息

      • getSelectedCheckbox

        public Checkbox getSelectedCheckbox​()
        从此复选框组获取当前选择。 当前的选择是此组中当前处于“开”状态的复选框，如果该组中的所有复选框都已关闭， null 。
        结果
        当前处于“开”状态的复选框，或 null 。
        从以下版本开始：
        1.1
        另请参见：
        Checkbox ， setSelectedCheckbox(java.awt.Checkbox)

      • getCurrent

        @Deprecated
public Checkbox getCurrent​()
        已过时。 自JDK 1.1版起，由getSelectedCheckbox()替代。
        如果没有选中复选框，则返回此复选框组中的当前选项或 null 。
        结果
        选中的复选框

      • setSelectedCheckbox

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

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

        参数
        box - 将 Checkbox设为当前选择。
        从以下版本开始：
        1.1
        另请参见：
        Checkbox ， getSelectedCheckbox()

      • setCurrent

        @Deprecated
public void setCurrent​(Checkbox box)
        已过时。 从JDK 1.1版开始，由setSelectedCheckbox(Checkbox)替代。
        将此组中当前选中的复选框设置为指定的复选框，并取消所有其他复选框。
        参数
        box - 将 Checkbox设为当前选择。

      • toString

        public String toString​()
        返回此复选框组的字符串表示形式，包括其当前选择的值。
        重写：
        toString在 Object
        结果
        此复选框组的字符串表示形式。