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

Class CheckBoxTreeItem<T>

  • 参数类型
    T - TreeItem中包含的值的类型
    All Implemented Interfaces:
    EventTarget 

    public class CheckBoxTreeItem<T>
extends TreeItem<T>
    TreeItem子类增加了在选定的，未选择的和不确定的状态中的支持。 当与安装了CheckBoxTreeCell的TreeView结合使用时，这是非常有用的。

    CheckBoxTreeItem可以是independent或依赖。 默认情况下，CheckBoxTreeItem实例是依赖的，这意味着对TreeItem的选择状态的任何更改都将对父项和子项CheckBoxTreeItem实例产生影响。 如果CheckBoxTreeItem设置为独立，这意味着对该CheckBoxTreeItem的任何更改都不会直接影响父项和子项CheckBoxTreeItem实例的状态。

    indeterminate属性用于表示与CheckBox.indeterminateProperty()相同的概念，即复选框既不被选择也未选择。 这在TreeView中通常使用，当某些（但不是全部）分支的孩子被选中时。

    使用CheckBoxTreeItem类与CheckBoxTreeCell一起使用的简单示例如下所示： 

       // create the tree model CheckBoxTreeItem<String> jonathanGiles = new CheckBoxTreeItem<String>("Jonathan"); CheckBoxTreeItem<String> juliaGiles = new CheckBoxTreeItem<String>("Julia"); CheckBoxTreeItem<String> mattGiles = new CheckBoxTreeItem<String>("Matt"); CheckBoxTreeItem<String> sueGiles = new CheckBoxTreeItem<String>("Sue"); CheckBoxTreeItem<String> ianGiles = new CheckBoxTreeItem<String>("Ian"); CheckBoxTreeItem<String> gilesFamily = new CheckBoxTreeItem<String>("Giles Family"); gilesFamily.setExpanded(true); gilesFamily.getChildren().addAll(jonathanGiles, juliaGiles, mattGiles, sueGiles, ianGiles); // create the treeView final TreeView<String> treeView = new TreeView<String>(); treeView.setRoot(gilesFamily); // set the cell factory treeView.setCellFactory(CheckBoxTreeCell.<String>forTreeView());
    从以下版本开始：
    JavaFX 2.2
    另请参见：
    CheckBoxTreeCell ， TreeItem ， CheckBox

    • Property Detail

      • selected

        public final BooleanProperty selectedProperty
        A BooleanProperty用于表示此CheckBoxTreeItem的选定状态。
        结果
        该CheckBoxTreeItem的选定状态属性

      • independent

        public final BooleanProperty independentProperty
        A BooleanProperty用于表示此CheckBoxTreeItem的独立状态。 独立状态用于表示对单个CheckBoxTreeItem的更改是否应影响其父级和子级的状态。

        默认情况下，独立属性为false，这意味着当CheckBoxTreeItem对所选或不确定的属性进行状态更改时，相关的CheckBoxTreeItems的状态可能会被更改。 如果独立属性设置为true，则相关的CheckBoxTreeItems的状态将永远不会改变。

        另请参见：
        isIndependent() ， setIndependent(boolean)

    • 构造方法详细信息

      • CheckBoxTreeItem

        public CheckBoxTreeItem​()
        创建一个空的CheckBoxTreeItem。

      • CheckBoxTreeItem

        public CheckBoxTreeItem​(T value)
        创建一个CheckBoxTreeItem，其value属性设置为提供的对象。
        参数
        value - 要存储的对象作为此TreeItem的值。

      • CheckBoxTreeItem

        public CheckBoxTreeItem​(T value,
                        Node graphic)
        创建一个CheckBoxTreeItem，其value属性设置为提供的对象，图形设置为提供的节点。
        参数
        value - 要存储的对象作为此CheckBoxTreeItem的值。
        graphic - 节点显示在此CheckBoxTreeItem旁边的TreeView中。

      • CheckBoxTreeItem

        public CheckBoxTreeItem​(T value,
                        Node graphic,
                        boolean selected)
        创建一个CheckBoxTreeItem，其value属性设置为提供的对象，图形设置为提供的Node，并将 selectedProperty()的初始状态设置为提供的布尔值。
        参数
        value - 要存储的对象作为此CheckBoxTreeItem的值。
        graphic - 节点显示在此CheckBoxTreeItem旁边的TreeView中。
        selected - selected属性的初始值。

      • CheckBoxTreeItem

        public CheckBoxTreeItem​(T value,
                        Node graphic,
                        boolean selected,
                        boolean independent)
        创建一个CheckBoxTreeItem，其中value属性设置为提供的对象，图形设置为提供的Node， selectedProperty()的初始状态设置为提供的布尔值，以及 independent属性的初始状态为提供的布尔值。
        参数
        value - 要存储的对象作为此CheckBoxTreeItem的值。
        graphic - 节点显示在此CheckBoxTreeItem旁边的TreeView中。
        selected - selected属性的初始值。
        independent - independent属性的初始值

    • 方法详细信息

      • checkBoxSelectionChangedEvent

        public static <T> EventType<CheckBoxTreeItem.TreeModificationEvent<T>> checkBoxSelectionChangedEvent​()
        当CheckBoxTreeItem选择/不确定状态改变时使用的EventType。 要使用它，建议您使用以下代码： 
           child1.addEventHandler(CheckBoxTreeItem.<String>checkBoxSelectionChangedEvent(), new EventHandler<TreeModificationEvent<String>>() { public void handle(TreeModificationEvent<String> event) { ... } });
        参数类型
        T - TreeItem中包含的值的类型。
        结果
        当CheckBoxTreeItem选择/不确定状态改变时使用的EventType

      • setSelected

        public final void setSelected​(boolean value)
        设置此CheckBoxTreeItem的选定状态。
        参数
        value - 此CheckBoxTreeItem的选定状态

      • isSelected

        public final boolean isSelected​()
        返回此CheckBoxTreeItem的选定状态。
        结果
        如果选中CheckBoxTreeItem，则为true

      • selectedProperty

        public final BooleanProperty selectedProperty​()
        A BooleanProperty用于表示此CheckBoxTreeItem的选定状态。
        结果
        该CheckBoxTreeItem的选定状态属性

      • setIndeterminate

        public final void setIndeterminate​(boolean value)
        设置此CheckBoxTreeItem的不确定状态。
        参数
        value - 此CheckBoxTreeItem的不确定状态

      • isIndeterminate

        public final boolean isIndeterminate​()
        返回此CheckBoxTreeItem的不确定状态。
        结果
        如果CheckBoxTreeItem是不确定状态，则为true

      • independentProperty

        public final BooleanProperty independentProperty​()
        A BooleanProperty用于表示此CheckBoxTreeItem的独立状态。 独立状态用于表示对单个CheckBoxTreeItem的更改是否应影响其父级和子级的状态。

        默认情况下，独立属性为false，这意味着当CheckBoxTreeItem对所选或不确定的属性进行状态更改时，相关的CheckBoxTreeItems的状态可能会被更改。 如果独立属性设置为true，则相关的CheckBoxTreeItems的状态将永远不会改变。

        另请参见：
        isIndependent() ， setIndependent(boolean)

      • setIndependent

        public final void setIndependent​(boolean value)
        设置属性的值独立。
        Property description:
        A BooleanProperty用于表示此CheckBoxTreeItem的独立状态。 独立状态用于表示对单个CheckBoxTreeItem的更改是否应影响其父级和子级的状态。

        默认情况下，独立属性为false，这意味着当CheckBoxTreeItem对所选或不确定的属性进行状态更改时，相关的CheckBoxTreeItems的状态可能会被更改。 如果独立属性设置为true，则相关的CheckBoxTreeItems的状态将永远不会改变。

      • isIndependent

        public final boolean isIndependent​()
        获取属性的值独立。
        Property description:
        A BooleanProperty用于表示此CheckBoxTreeItem的独立状态。 独立状态用于表示对单个CheckBoxTreeItem的更改是否应影响其父级和子级的状态。

        默认情况下，独立属性为false，这意味着当CheckBoxTreeItem对所选或不确定的属性进行状态更改时，相关的CheckBoxTreeItems的状态可能会被更改。 如果独立属性设置为true，则相关的CheckBoxTreeItems的状态将永远不会改变。