Module  javafx.controls

Class ComboBoxListCell<T>

  • 参数类型
    T - ListView中包含的元素的类型。
    All Implemented Interfaces:
    StyleableEventTargetSkinnable


    public class ComboBoxListCell<T>
    extends ListCell<T>
    一个包含ListCell实现的类,在该单元格内绘制一个ComboBox节点。

    默认情况下,ComboBoxListCell在不被编辑时呈现为Label ,而在编辑模式时则作为ComboBox呈现。 默认情况下,ComboBox将拉伸以填充整个列表单元格。

    要创建一个ComboBoxListCell,有必要提供零或更多的项目,当ComboBox菜单显示时,将显示给用户。 这些项目必须与ListView项目序列具有相同的类型,以便在选择后,它们将替换items列表中的现有值。

    从以下版本开始:
    JavaFX 2.2
    • 构造方法详细信息

      • ComboBoxListCell

        public ComboBoxListCell​()
        创建一个带有空项目列表的默认ComboBoxListCell。
      • ComboBoxListCell

        @SafeVarargs
        public ComboBoxListCell​(T... items)
        创建默认的ComboBoxListCell实例,给定的项目用于在显示ComboBox时填充ComboBox
        参数
        items - 由用户选择时在ComboBox弹出菜单中显示的项目。
      • ComboBoxListCell

        @SafeVarargs
        public ComboBoxListCell​(StringConverter<T> converter,
                                T... items)
        创建一个ComboBoxListCell实例,给定的项目用于在显示ComboBox时填充ComboBox ,而StringConverter用于将项目转换为用户可读的形式。
        参数
        converter - A StringConverter ,可以将T类型的项目转换为用户可读的字符串,以便可以在ComboBox弹出菜单中显示。
        items - 由用户选择时在ComboBox弹出菜单中显示的项目。
      • ComboBoxListCell

        public ComboBoxListCell​(ObservableList<T> items)
        创建默认的ComboBoxListCell实例,给定的项目用于在显示ComboBox时填充ComboBox
        参数
        items - 由用户选择时在ComboBox弹出菜单中显示的项目。
      • ComboBoxListCell

        public ComboBoxListCell​(StringConverter<T> converter,
                                ObservableList<T> items)
        创建一个ComboBoxListCell实例,给定的项目用于在显示ComboBox时填充ComboBox ,而StringConverter用于将项目转换为用户可读的形式。
        参数
        converter - A StringConverter ,可以将T类型的项目转换为用户可读的字符串,以便可以在ComboBox弹出菜单中显示。
        items - 由用户选择时在ComboBox弹出菜单中显示的项目。
    • 方法详细信息

      • forListView

        @SafeVarargs
        public static <T> Callback<ListView<T>,ListCell<T>> forListView​(T... items)
        创建ComboBox单元格工厂,用于ListView控件。 默认情况下,ComboBoxCell在不被编辑时被渲染为Label ,而在编辑模式下则作为ComboBox呈现。 默认情况下,ComboBox将拉伸以填充整个列表单元格。
        参数类型
        T - ListView中包含的元素的类型。
        参数
        items - 当显示ComboBox菜单时将显示给用户的零个或多个项目。 这些项目必须与ListView项目列表的类型相同,以便在选择时,它们将替换items列表中的现有值。
        结果
        A Callback将返回能够处理ListView中包含的元素类型的ListCell。
      • forListView

        @SafeVarargs
        public static <T> Callback<ListView<T>,ListCell<T>> forListView​(StringConverter<T> converter,
                                                                        T... items)
        创建ComboBox单元格工厂,用于ListView控件。 默认情况下,ComboBoxCell在不被编辑时被渲染为Label ,而在编辑模式时则作为ComboBox呈现。 默认情况下,ComboBox将拉伸以填充整个列表单元格。
        参数类型
        T - ListView中包含的元素的类型。
        参数
        converter - A StringConverter将给定项目(类型T)转换为用于显示给用户的字符串。
        items - 当显示ComboBox菜单时将显示给用户的零个或多个项目。 这些项目必须与ListView项目列表的类型相同,以便在选择时,它们将替换items列表中的现有值。
        结果
        A Callback将返回能够处理ListView中包含的元素类型的ListCell。
      • forListView

        public static <T> Callback<ListView<T>,ListCell<T>> forListView​(ObservableList<T> items)
        创建ComboBox单元格工厂,用于ListView控件。 默认情况下,ComboBoxCell在不被编辑时被渲染为Label ,而在编辑模式下则作为ComboBox呈现。 默认情况下,ComboBox将拉伸以填充整个列表单元格。
        参数类型
        T - ListView中包含的元素的类型。
        参数
        items -一个ObservableList包含零个或多个项目将被显示给用户时, ComboBox显示菜单时。 这些项目必须与ListView项目序列具有相同的类型,以便在选择时,它们将替换items列表中的现有值。
        结果
        A Callback将返回能够处理ListView中包含的元素类型的ListCell。
      • forListView

        public static <T> Callback<ListView<T>,ListCell<T>> forListView​(StringConverter<T> converter,
                                                                        ObservableList<T> items)
        创建ComboBox单元格工厂,用于ListView控件。 默认情况下,ComboBoxCell在不被编辑时被渲染为Label ,在编辑模式时作为ComboBox呈现。 默认情况下,ComboBox将拉伸以填充整个列表单元格。
        参数类型
        T - ListView中包含的元素的类型。
        参数
        converter - A StringConverter将给定的项目(类型T)转换为用于显示给用户的字符串。
        items - 一个ObservableList包含零个或多个项目,当ComboBox菜单显示时将显示给用户。 这些项目必须与ListView项目序列具有相同的类型,以便在选择时,它们将替换items列表中的现有值。
        结果
        A Callback将返回能够处理ListView中包含的元素类型的ListCell。
      • setComboBoxEditable

        public final void setComboBoxEditable​(boolean value)
        将ComboBox配置为可编辑(允许用户输入超出下拉列表中提供的选项)。
        参数
        value - 此ComboBox的可编辑值
      • isComboBoxEditable

        public final boolean isComboBoxEditable​()
        如果ComboBox是可编辑的,则返回true。
        结果
        如果ComboBox是可编辑的,则为true
      • getItems

        public ObservableList<T> getItems​()
        返回要显示在ChoiceBox中的项目。
        结果
        要显示在ChoiceBox中的项目
      • startEdit

        public void startEdit​()
        调用此功能从非编辑状态转换到编辑状态,如果单元格是可编辑的。 如果这个单元格已经处于编辑状态,它将保留在它中。
        重写:
        startEditListCell<T>
      • cancelEdit

        public void cancelEdit​()
        调用此功能从编辑状态转换为非编辑状态,而不保存任何用户输入。
        重写:
        cancelEditListCell<T>
      • updateItem

        public void updateItem​(T item,
                               boolean empty)
        updateItem方法不应该被开发人员调用,但它是开发人员覆盖的最佳方式,以允许它们自定义单元格的视觉效果。 为了弄清楚,开发人员不应该在他们的代码中调用这个方法(他们应该留给UI控件,比如ListView控件)来调用这个方法。 然而,使用updateItem方法的目的是使开发人员在指定自定义单元工厂时(再次像ListView cell factory ),可以覆盖updateItem方法,以允许对单元格进行完全自定义。

        非常重要的是,Cell的子类会正确覆盖updateItem方法,因为这样做会导致诸如空白单元格或其中出现意外内容的单元格等问题。 以下是如何正确覆盖updateItem方法的示例:

          protected void updateItem(T item, boolean empty) {
             super.updateItem(item, empty);
        
             if (empty || item == null) {
                 setText(null);
                 setGraphic(null);
             } else {
                 setText(item.toString());
             }
         } 

        注意在这段代码示例中的两个重点:

        1. 我们称之为super.updateItem(T,boolean)方法。 如果没有这样做,项目和空属性设置不正确,您可能会遇到图形问题。
        2. 我们测试empty条件,如果为true,我们将文本和图形属性设置为null。 如果我们不这样做,几乎可以保证最终用户意外地看到细胞中的图形工件。
        重写:
        updateItemCell<T>
        参数
        item - 单元格的新项目。
        empty - 该单元格是否表示列表中的数据。 如果它是空的,那么它不表示任何域数据,而是用于呈现“空”行的单元格。