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

Class ComboBoxBase<T>

  • 参数类型
    T - 已选择或以其他方式输入到此ComboBox的值的类型。
    All Implemented Interfaces:
    Styleable ， EventTarget ， Skinnable
    已知直接子类：
    ColorPicker ， ComboBox ， DatePicker 

    public abstract class ComboBoxBase<T>
extends Control
    ComboBox类控件的抽象基类。 ComboBox通常具有一个按钮，当被点击时，会弹出一些允许用户选择一个或多个值（取决于实现）的方法。 这个基类不会考虑当调用show()和hide()方法时会发生什么，但是通常会导致出现弹出窗口或对话框，从而允许用户提供所需的信息。

    ComboBox有一个表示当前用户输入的value属性。 这可以基于从下拉列表中的选择，或者当ComboBox是editable时可能来自用户输入。

    一个editable ComboBox是为最终用户提供一些手段，为其他可选择的选项提供输入。 例如，在ComboBox实现中，可编辑的ComboBox提供了可能键入的TextField 。 如上所述，当用户将文本输入提交到文本字段（通常按Enter键盘键）时， value属性将被更新。

    这个类与ComboBox之间的分离的目的是允许不一定弹出一个项目列表的类似ComboBox的控件。 其他实现的示例包括颜色选择器，日历选择器等。ComboBox类提供了默认的，最常见的预期实现。 有关更多信息，请参阅javadoc类。

    从以下版本开始：
    JavaFX 2.1
    另请参见：
    ComboBox

    • 字段详细信息

      • ON_SHOWING

        public static final EventType<Event> ON_SHOWING

        在ComboBox之前调用，在用户单击或以其他方式与ComboBox进行交互之后显示弹出/显示。

        从以下版本开始：
        JavaFX 2.2

      • ON_SHOWN

        public static final EventType<Event> ON_SHOWN

        在ComboBox显示弹出/显示后调用。

        从以下版本开始：
        JavaFX 2.2

      • ON_HIDING

        public static final EventType<Event> ON_HIDING

        当ComboBox弹出/显示将被隐藏时调用。

        从以下版本开始：
        JavaFX 2.2

      • ON_HIDDEN

        public static final EventType<Event> ON_HIDDEN

        当ComboBox弹出/显示已被隐藏时调用。

        从以下版本开始：
        JavaFX 2.2

    • 构造方法详细信息

      • ComboBoxBase

        public ComboBoxBase​()
        创建默认的ComboBoxBase实例。

    • 方法详细信息

      • valueProperty

        public ObjectProperty<T> valueProperty​()
        如果输入不可编辑，或者如果可编辑，则该组合框的值被定义为所选项，最近的用户操作：用户输入的值或最后选择的项。
        另请参见：
        getValue() ， setValue(T)

      • setValue

        public final void setValue​(T value)
        设置属性值的值。
        Property description:
        如果输入不可编辑，或者如果可编辑，则该组合框的值被定义为所选项，最近的用户操作：用户输入的值或最后选择的项。

      • getValue

        public final T getValue​()
        获取属性值的值。
        Property description:
        如果输入不可编辑，或者如果可编辑，则该组合框的值被定义为所选项，最近的用户操作：用户输入的值或最后选择的项。

      • editableProperty

        public BooleanProperty editableProperty​()
        指定ComboBox是否允许用户输入。 当可编辑为true时，ComboBox具有用户可能键入的文本输入区域。 此输入可通过value属性获得。

        请注意，当editable属性更改时，value属性将重新设置，以及任何其他相关状态。

        另请参见：
        isEditable() ， setEditable(boolean)

      • setEditable

        public final void setEditable​(boolean value)
        设置属性可编辑的值。
        Property description:
        指定ComboBox是否允许用户输入。 当可编辑为true时，ComboBox具有用户可能键入的文本输入区域。 此输入可通过value属性获得。

        请注意，当editable属性更改时，value属性将重新设置，以及任何其他相关状态。

      • isEditable

        public final boolean isEditable​()
        获取可编辑属性的值。
        Property description:
        指定ComboBox是否允许用户输入。 当可编辑为true时，ComboBox具有用户可能键入的文本输入区域。 此输入可通过value属性获得。

        请注意，当editable属性更改时，value属性将重新设置，以及任何其他相关状态。

      • showingProperty

        public ReadOnlyBooleanProperty showingProperty​()
        表示ComboBox弹出窗口的当前状态，以及当前是否在屏幕上可见（尽管可能隐藏在其他窗口后面）。
        另请参见：
        isShowing()

      • isShowing

        public final boolean isShowing​()
        获取显示的属性的值。
        Property description:
        表示ComboBox弹出窗口的当前状态，以及当前是否在屏幕上可见（尽管可能隐藏在其他窗口后面）。

      • promptTextProperty

        public final StringProperty promptTextProperty​()
        ComboBox提示文本显示，如果没有显示提示文本，则显示null 。 在所有情况下不显示提示文本，它将依赖于ComboBoxBase的子类，以便在显示promptText时进行说明。 例如，在大多数情况下，当组合框不可编辑时（即，仅当通过文本输入允许用户输入时才显示提示文本），提示文本将永远不会显示。
        另请参见：
        getPromptText() ， setPromptText(String)

      • getPromptText

        public final String getPromptText​()
        获取属性promptText的值。
        Property description:
        ComboBox提示文本显示，如果没有显示提示文本，则显示null 。 在所有情况下不显示提示文本，它将依赖于ComboBoxBase的子类，以便在显示promptText时进行说明。 例如，在大多数情况下，当组合框不可编辑时（即，仅当通过文本输入允许用户输入时才显示提示文本），提示文本将永远不会显示。

      • setPromptText

        public final void setPromptText​(String value)
        设置属性promptText的值。
        Property description:
        ComboBox提示文本显示，如果没有显示提示文本， null 。 在所有情况下不显示提示文本，它将依赖于ComboBoxBase的子类，以便在显示promptText时进行说明。 例如，在大多数情况下，当组合框不可编辑时（即，仅当通过文本输入允许用户输入时才显示提示文本），提示文本将永远不会显示。

      • armedProperty

        public BooleanProperty armedProperty​()
        表示ComboBox已被“布防”，以便鼠标释放将导致ComboBox show()方法被调用。 这与压制有所不同。 Pressed表示鼠标已经在节点上按下并且尚未被释放。 arm但是也考虑到鼠标是否实际上是在ComboBox上按下。
        另请参见：
        isArmed()

      • isArmed

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

      • setOnAction

        public final void setOnAction​(EventHandler<ActionEvent> value)
        设置属性onAction的值。
        Property description:
        ComboBox操作，当ComboBox value属性更改时调用。 这可能是由于value属性被程序改变，当用户选择弹出列表或对话框中的项目时，或者在editable ComboBoxes的情况下，可能是当用户提供自己的输入（通过TextField X- 200 200 X- 200 200 X- 200 200 X- 200 200 X-

      • getOnAction

        public final EventHandler<ActionEvent> getOnAction​()
        获取属性onAction的值。
        Property description:
        ComboBox操作，当ComboBox value属性更改时调用。 这可能是由于value属性被程序更改，当用户选择弹出列表或对话框中的项目时，或者在editable组合框的情况下，可能是用户提供自己的输入（通过TextField或其他一些输入机制。

      • setOnShowing

        public final void setOnShowing​(EventHandler<Event> value)
        设置属性onShowing的值。
        Property description:
        在 ComboBoxBase弹出/显示之前调用。
        从以下版本开始：
        JavaFX 2.2

      • getOnShowing

        public final EventHandler<Event> getOnShowing​()
        获取属性onShowing的值。
        Property description:
        在 ComboBoxBase弹出/显示之前调用。
        从以下版本开始：
        JavaFX 2.2

      • setOnShown

        public final void setOnShown​(EventHandler<Event> value)
        设置属性onShown的值。
        Property description:
        在显示ComboBoxBase弹出/显示之后调用。
        从以下版本开始：
        JavaFX 2.2

      • getOnShown

        public final EventHandler<Event> getOnShown​()
        获取onShown属性的值。
        Property description:
        在显示ComboBoxBase弹出/显示后调用。
        从以下版本开始：
        JavaFX 2.2

      • setOnHiding

        public final void setOnHiding​(EventHandler<Event> value)
        设置属性onHiding的值。
        Property description:
        在ComboBox弹出/显示被隐藏之前调用。
        从以下版本开始：
        JavaFX 2.2

      • getOnHiding

        public final EventHandler<Event> getOnHiding​()
        获取属性onHiding的值。
        Property description:
        在ComboBox弹出/显示被隐藏之前调用。
        从以下版本开始：
        JavaFX 2.2

      • setOnHidden

        public final void setOnHidden​(EventHandler<Event> value)
        设置属性onHidden的值。
        Property description:
        在ComboBoxBase弹出/显示已被隐藏之后调用。
        从以下版本开始：
        JavaFX 2.2

      • getOnHidden

        public final EventHandler<Event> getOnHidden​()
        获取属性onHidden的值。
        Property description:
        在ComboBoxBase弹出/显示已被隐藏之后调用。
        从以下版本开始：
        JavaFX 2.2

      • show

        public void show​()
        请求ComboBox显示用户界面的弹出窗口。 如ComboBoxBase类javadoc中所提到的，调用此方法时实际显示的内容是未定义的，但通常它是某种形式的弹出窗口或对话窗口。

      • hide

        public void hide​()
        关闭当 调用show()时显示的弹出/对话框。

      • arm

        public void arm​()
        武装ComboBox。 武装的ComboBox将在下一个预期的UI手势上显示一个弹出列表。 注意：此功能主要由专家使用，主要由实施新皮肤或行为的人员使用。 开发人员或设计师直接访问此功能并不常见。

      • disarm

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

      • queryAccessibleAttribute

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

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

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

      • executeAccessibleAction

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

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

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