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

Class ComboBoxBase<T>

  • 参数类型
    T - 已选择或以其他方式输入到此ComboBox的值的类型。
    All Implemented Interfaces:
    StyleableEventTargetSkinnable
    已知直接子类:
    ColorPickerComboBoxDatePicker


    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)
        该方法由辅助技术调用以请求属性的值。

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

        重写:
        queryAccessibleAttributeControl
        参数
        attribute - 请求的属性
        parameters - 可选参数列表
        结果
        请求的属性的值
        另请参见:
        AccessibleAttribute
      • executeAccessibleAction

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

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

        重写:
        executeAccessibleActionControl
        参数
        action - 要执行的操作
        parameters - 可选参数列表
        另请参见:
        AccessibleAction