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

Class ButtonBase

  • All Implemented Interfaces:
    Styleable ， EventTarget ， Skinnable
    已知直接子类：
    Button ， CheckBox ， Hyperlink ， MenuButton ， ToggleButton 

    public abstract class ButtonBase
extends Labeled
    按钮式UI控件的基类，包括超链接，按钮，ToggleButtons，复选框和RadioButtons。 ButtonBase的主要贡献是提供一致的API来处理按钮“布防”的概念。 在UI中，按钮通常只会在按钮“布防”时发生某些用户手势“触发”。 例如，如果鼠标被按下并且按钮被启用并且鼠标在按钮上方，则按钮可以被布防。 在这种情况下，如果鼠标被释放，则按钮被“触发”，意味着它的动作发生。
    从以下版本开始：
    JavaFX 2.0

    • Property Detail

      • armed

        public final ReadOnlyBooleanProperty armedProperty
        表示该按钮已被“布防”，使得鼠标释放将导致按钮的动作被调用。 这与压制有所不同。 Pressed表示鼠标已经在节点上按下并且尚未被释放。 arm但是也考虑到鼠标是否实际上在按钮上按下。
        另请参见：
        isArmed()

    • 构造方法详细信息

      • ButtonBase

        public ButtonBase​()
        创建一个带有空文本的默认ButtonBase。

      • ButtonBase

        public ButtonBase​(String text)
        创建一个带有给定文本的ButtonBase。
        参数
        text - 空文本被视为空字符串

      • ButtonBase

        public ButtonBase​(String text,
                  Node graphic)
        创建一个带有给定文本和图形的ButtonBase。
        参数
        text - 空文本被视为空字符串
        graphic - 一个空图形是可以接受的

    • 方法详细信息

      • armedProperty

        public final ReadOnlyBooleanProperty armedProperty​()
        表示该按钮已被“布防”，使得鼠标释放将导致按钮的动作被调用。 这与压制有所不同。 Pressed表示鼠标已经在节点上按下并且尚未被释放。 然而， arm还考虑了鼠标是否实际上在按钮上按下。
        另请参见：
        isArmed()

      • isArmed

        public final boolean isArmed​()
        获得武器的价值。
        Property description:
        表示该按钮已被“布防”，使得鼠标释放将导致按钮的动作被调用。 这与压制有所不同。 Pressed表示鼠标已经在节点上按下并且尚未被释放。 arm但是也考虑到鼠标是否实际上在按钮上按下。

      • setOnAction

        public final void setOnAction​(EventHandler<ActionEvent> value)
        设置属性onAction的值。
        Property description:
        按钮的动作，当按钮被触发时被调用。 这可能是由于用户使用鼠标点击按钮，或者通过触摸事件或按键，或者如果开发者以编程方式调用fire()方法。

      • getOnAction

        public final EventHandler<ActionEvent> getOnAction​()
        获取属性onAction的值。
        Property description:
        按钮的动作，当按钮被触发时被调用。 这可能是由于用户用鼠标点击按钮，或者通过触摸事件或按键，或者如果开发者以编程方式调用fire()方法。

      • arm

        public void arm​()
        按下按钮。 一个全副武装的按钮将火的动作（不管是一个的动作Button或切换选择在CheckBox或其他一些行为）上的下一个预期的UI手势。 注意：此功能主要由专家使用，主要由实施新皮肤或行为的人员使用。 开发人员或设计师直接访问此功能并不常见。

      • disarm

        public void disarm​()
        取消按钮。 见arm() 。 注意：此功能主要由专家使用，主要由实施新皮肤或行为的人员使用。 开发人员或设计师直接访问此功能并不常见。

      • fire

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

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

      • executeAccessibleAction

        public void executeAccessibleAction​(AccessibleAction action,
                                    Object... parameters)
        该方法由辅助技术调用，请求执行由参数指示的动作。

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

        重写：
        executeAccessibleAction在 Control
        参数
        action - 要执行的操作
        parameters - 可选参数列表
        另请参见：
        AccessibleAction