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

Class ComboBoxTreeTableCell<S,T>

  • 参数类型
    S - TreeTableView泛型类型的类型
    T - TreeTableColumn中包含的元素的类型。
    All Implemented Interfaces:
    Styleable ， EventTarget ， Skinnable 

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

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

    要创建一个ComboBoxTreeTableCell，当显示ComboBox菜单时，需要提供零个或多个将显示给用户的项目 。 这些项目必须与TreeTableColumn类型相同。

    从以下版本开始：
    JavaFX 8.0

    • 构造方法详细信息

      • ComboBoxTreeTableCell

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

      • ComboBoxTreeTableCell

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

      • ComboBoxTreeTableCell

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

      • ComboBoxTreeTableCell

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

      • ComboBoxTreeTableCell

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

    • 方法详细信息

      • forTreeTableColumn

        @SafeVarargs
public static <S,T> Callback<TreeTableColumn<S,T>,TreeTableCell<S,T>> forTreeTableColumn​(T... items)
        创建ComboBox单元格工厂，用于TreeTableColumn控件。 默认情况下，ComboBoxCell在不被编辑时呈现为Label ，而在编辑模式下则为 ComboBox。 默认情况下，ComboBox将拉伸以填充整个列表单元格。
        参数类型
        S - TreeTableView泛型类型的类型
        T - TreeTableColumn中包含的元素的类型。
        参数
        items - 当显示ComboBox菜单时将显示给用户的零个或多个项目。 这些项目必须与TreeTableColumn类型相同。 请注意，由开发人员设置event handlers以监听TreeTableColumn中的编辑事件，并作出相应的反应。 感兴趣的方法包括： setOnEditStart ， setOnEditCommit ，并setOnEditCancel 。
        结果
        A Callback将返回一个TreeTableCell，它能够处理TreeTableColumn中包含的元素的类型。

      • forTreeTableColumn

        @SafeVarargs
public static <S,T> Callback<TreeTableColumn<S,T>,TreeTableCell<S,T>> forTreeTableColumn​(StringConverter<T> converter,
                                                                                         T... items)
        创建ComboBox单元格工厂，用于TreeTableColumn控件。 默认情况下，ComboBoxCell在不被编辑时被渲染为Label ，在编辑模式时作为ComboBox呈现。 默认情况下，ComboBox将拉伸以填充整个列表单元格。
        参数类型
        S - TreeTableView泛型类型的类型
        T - TreeTableColumn中包含的元素的类型。
        参数
        converter - A StringConverter将给定项目（类型T）转换为用于显示给用户的字符串。
        items - 当显示ComboBox菜单时将显示给用户的零个或多个项目。 这些项目必须与TreeTableColumn类型相同。 请注意，由开发人员设置event handlers以监听TreeTableColumn中的编辑事件，并作出相应的反应。 感兴趣的方法包括： setOnEditStart ， setOnEditCommit ，并setOnEditCancel 。
        结果
        A Callback将返回一个TreeTableCell，它可以处理TreeTableColumn中包含的元素的类型。

      • forTreeTableColumn

        public static <S,T> Callback<TreeTableColumn<S,T>,TreeTableCell<S,T>> forTreeTableColumn​(ObservableList<T> items)
        创建ComboBox单元格工厂用于TreeTableColumn控件。 默认情况下，ComboBoxCell在不被编辑时呈现为Label ，在编辑模式时则作为ComboBox呈现。 默认情况下，ComboBox将拉伸以填充整个列表单元格。
        参数类型
        S - TreeTableView泛型类型的类型
        T - TreeTableColumn中包含的元素的类型。
        参数
        items - 当显示ComboBox菜单时将显示给用户的零个或多个项目。 这些项目必须与TreeTableColumn类型相同。 请注意，由开发人员设置event handlers以监听TreeTableColumn中的编辑事件，并作出相应的响应。 感兴趣的方法包括： setOnEditStart ， setOnEditCommit ，并setOnEditCancel 。
        结果
        A Callback将返回一个TreeTableCell，它能够处理TreeTableColumn中包含的元素的类型。

      • forTreeTableColumn

        public static <S,T> Callback<TreeTableColumn<S,T>,TreeTableCell<S,T>> forTreeTableColumn​(StringConverter<T> converter,
                                                                                         ObservableList<T> items)
        创建ComboBox单元格工厂，用于TreeTableColumn控件。 默认情况下，ComboBoxCell在不被编辑时呈现为Label ，在编辑模式时则作为ComboBox呈现。 默认情况下，ComboBox将拉伸以填充整个列表单元格。
        参数类型
        S - TreeTableView泛型类型的类型
        T - TreeTableColumn中包含的元素的类型。
        参数
        converter - A StringConverter将给定项目（类型T）转换为用于显示给用户的字符串。
        items - 当显示ComboBox菜单时，将显示给用户的零个或多个项目。 这些项目必须与TreeTableColumn类型相同。 请注意，由开发人员设置event handlers以监听TreeTableColumn中的编辑事件，并作出相应的响应。 感兴趣的方法包括： setOnEditStart ， setOnEditCommit ，并setOnEditCancel 。
        结果
        A Callback将返回一个TreeTableCell，它可以处理TreeTableColumn中包含的元素的类型。

      • setConverter

        public final void setConverter​(StringConverter<T> value)
        设置要在此单元格中使用的StringConverter 。
        参数
        value - 字符串转换器

      • setComboBoxEditable

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

      • isComboBoxEditable

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

      • getItems

        public ObservableList<T> getItems​()
        返回要显示在ComboBox中的项目。
        结果
        当该组合框显示时要显示的项目

      • startEdit

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

      • cancelEdit

        public void cancelEdit​()
        调用此功能从编辑状态转换为非编辑状态，而不保存任何用户输入。
        重写：
        cancelEdit在 TreeTableCell<S,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。 如果我们不这样做，几乎可以保证最终用户意外地看到细胞中的图形工件。
        重写：
        updateItem在 Cell<T>
        参数
        item - 单元格的新项目。
        empty - whether or not this cell represents data from the list. If it is empty, then it does not represent any domain data, but is a cell being used to render an "empty" row.