Module  javafx.controls
软件包  javafx.scene.control

Class ToggleButton

  • All Implemented Interfaces:
    Styleable ， EventTarget ， Skinnable ， Toggle
    已知直接子类：
    RadioButton 

    public class ToggleButton
extends ButtonBase
implements Toggle
    A ToggleButton是一种具有选择能力的专业控制。 通常， ToggleButton与Button类似。 但是，它们是两种不同类型的控件。 一个按钮是一个“命令”按钮，它在单击时调用一个功能。 另一方面，A ToggleButton仅仅是一个布尔值的控件，指示是否已被选择。

    ToggleButton也可以放在一起。 默认情况下， ToggleButton不在组中。 在组中，可以选择该组内一次只能有一个ToggleButton 。 要将两个ToggleButtons放在同一组中，只需为ToggleGroup分配相同的值即可 。

    不像RadioButtons ， ToggleButtons在ToggleGroup不要尝试强行至少一个选择ToggleButton在一组。 也就是说，如果选择了ToggleButton ，点击它将导致它被取消选择。 使用RadioButton ，点击组中的所选按钮将不起作用。

    例： 

       ToggleButton tb1 = new ToggleButton("toggle button 1"); ToggleButton tb2 = new ToggleButton("toggle button 2"); ToggleButton tb3 = new ToggleButton("toggle button 3"); ToggleGroup group = new ToggleGroup(); tb1.setToggleGroup(group); tb2.setToggleGroup(group); tb3.setToggleGroup(group);

    默认情况下，ToggleButton启用助记符解析。

    从以下版本开始：
    JavaFX 2.0

    • 构造方法详细信息

      • ToggleButton

        public ToggleButton​()
        为其标签创建一个空字符串的切换按钮。

      • ToggleButton

        public ToggleButton​(String text)
        创建具有指定文本的切换按钮作为其标签。
        参数
        text - 其标签的文本字符串。

      • ToggleButton

        public ToggleButton​(String text,
                    Node graphic)
        创建一个切换按钮，其标签具有指定的文本和图标。
        参数
        text - 其标签的文本字符串。
        graphic - 其标签的图标。

    • 方法详细信息

      • setSelected

        public final void setSelected​(boolean value)
        设置所选属性的值。
        Specified by:
        setSelected在接口 Toggle
        Property description:
        指示是否选择此切换按钮。 这可以通过编程方式进行操作。
        参数
        value - true使这个 Toggle选择。

      • isSelected

        public final boolean isSelected​()
        获取所选属性的值。
        Specified by:
        isSelected在接口 Toggle
        Property description:
        指示是否选择此切换按钮。 这可以通过编程方式进行操作。
        结果
        true如果这个 Toggle被选中。

      • setToggleGroup

        public final void setToggleGroup​(ToggleGroup value)
        设置属性toggleGroup的值。
        Specified by:
        setToggleGroup在接口 Toggle
        Property description:
        该ToggleGroup到这个ToggleButton所属。 A ToggleButton只能在任何一个时间在一个组。 如果组更改，则在添加到新组之前，该按钮将从旧组中删除。
        参数
        value - 新的ToggleGroup 。

      • getToggleGroup

        public final ToggleGroup getToggleGroup​()
        获取属性toggleGroup的值。
        Specified by:
        getToggleGroup在接口 Toggle
        Property description:
        该ToggleGroup到这个ToggleButton所属。 A ToggleButton只能在任何一个时间在一个组。 如果组更改，则在添加到新组之前，该按钮将从旧组中删除。
        结果
        该ToggleGroup到这个Toggle所属。

      • fire

        public void fire​()
        当用户手势指示应发生ButtonBase的事件时调用。

        如果被调用，无论ButtonBase.arm()的状态如何，都将执行此方法。

        Specified by:
        fire在 ButtonBase

      • createDefaultSkin

        protected Skin<?> createDefaultSkin​()
        为此控件创建一个新的默认皮肤实例。 如果没有通过CSS -fx-skin提供皮肤或者在具有setSkin(...)的子类中显式设置，则调用此控件创建皮肤。
        重写：
        createDefaultSkin在 Control
        结果
        此控件的默认皮肤的新实例。 如果为null，则控件将没有皮肤，除非由css提供。

      • getInitialAlignment

        protected Pos getInitialAlignment​()
        返回此控件的初始对齐状态，供JavaFX CSS引擎正确设置其初始值。 该方法最初被覆盖使用Pos.CENTER。
        重写：
        getInitialAlignment在 Labeled
        结果
        该控件的初始对齐状态
        从以下版本开始：
        9

      • queryAccessibleAttribute

        public Object queryAccessibleAttribute​(AccessibleAttribute attribute,
                                       Object... parameters)
        该方法由辅助技术调用以请求属性的值。

        子类通常覆盖此方法来实现特定角色所需的属性。
        如果未处理特定属性，则必须调用超类实现。

        重写：
        queryAccessibleAttribute在 Control
        参数
        attribute - 请求的属性
        parameters - 可选参数列表
        结果
        请求的属性的值
        另请参见：
        AccessibleAttribute