- java.lang.Object
-
- javafx.scene.control.TreeItem<T>
-
- javafx.scene.control.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 Summary
Properties Type Property 描述 BooleanProperty
independent
ABooleanProperty
用于表示此CheckBoxTreeItem的独立状态。BooleanProperty
indeterminate
ABooleanProperty
用于表示此CheckBoxTreeItem的不确定状态。BooleanProperty
selected
ABooleanProperty
用于表示此CheckBoxTreeItem的选定状态。
-
Nested Class Summary
Nested Classes Modifier and Type Class 描述 static class
CheckBoxTreeItem.TreeModificationEvent<T>
一个类似于TreeItem.TreeModificationEvent
类的TreeModificationEvent类,因为这个事件会引发 CheckBoxTreeItem层次结构,直到父节点为空。
-
构造方法摘要
构造方法 Constructor 描述 CheckBoxTreeItem()
创建一个空的CheckBoxTreeItem。CheckBoxTreeItem(T value)
创建一个CheckBoxTreeItem,其value属性设置为提供的对象。CheckBoxTreeItem(T value, Node graphic)
创建一个CheckBoxTreeItem,其value属性设置为提供的对象,图形设置为提供的节点。CheckBoxTreeItem(T value, Node graphic, boolean selected)
创建一个CheckBoxTreeItem,其value属性设置为提供的对象,图形设置为提供的Node,并将selectedProperty()
的初始状态设置为提供的布尔值。CheckBoxTreeItem(T value, Node graphic, boolean selected, boolean independent)
创建具有设置为所提供的对象,该图形集所提供的节点,所述的初始状态下的值属性CheckBoxTreeItemselectedProperty()
组所提供的布尔值,和的初始状态independent
属性所提供的布尔值。
-
方法摘要
所有方法 静态方法 接口方法 具体的方法 Modifier and Type 方法 描述 static <T> EventType<CheckBoxTreeItem.TreeModificationEvent<T>>
checkBoxSelectionChangedEvent()
当CheckBoxTreeItem选择/不确定状态改变时使用的EventType。BooleanProperty
independentProperty()
ABooleanProperty
用于表示此CheckBoxTreeItem的独立状态。BooleanProperty
indeterminateProperty()
ABooleanProperty
用于表示此CheckBoxTreeItem的不确定状态。boolean
isIndependent()
获取属性的值独立。boolean
isIndeterminate()
返回此CheckBoxTreeItem的不确定状态。boolean
isSelected()
返回此CheckBoxTreeItem的选定状态。BooleanProperty
selectedProperty()
ABooleanProperty
用于表示此CheckBoxTreeItem的选定状态。void
setIndependent(boolean value)
设置属性的值独立。void
setIndeterminate(boolean value)
设置此CheckBoxTreeItem的不确定状态。void
setSelected(boolean value)
设置此CheckBoxTreeItem的选定状态。-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from class javafx.scene.control.TreeItem
addEventHandler, branchCollapsedEvent, branchExpandedEvent, buildEventDispatchChain, childrenModificationEvent, expandedItemCountChangeEvent, expandedProperty, getChildren, getGraphic, getParent, getValue, graphicChangedEvent, graphicProperty, isExpanded, isLeaf, leafProperty, nextSibling, nextSibling, parentProperty, previousSibling, previousSibling, removeEventHandler, setExpanded, setGraphic, setValue, toString, treeNotificationEvent, valueChangedEvent, valueProperty
-
-
-
-
Property Detail
-
selected
public final BooleanProperty selectedProperty
ABooleanProperty
用于表示此CheckBoxTreeItem的选定状态。- 结果
- 该CheckBoxTreeItem的选定状态属性
-
indeterminate
public final BooleanProperty indeterminateProperty
ABooleanProperty
用于表示此CheckBoxTreeItem的不确定状态。
-
independent
public final BooleanProperty independentProperty
ABooleanProperty
用于表示此CheckBoxTreeItem的独立状态。 独立状态用于表示对单个CheckBoxTreeItem的更改是否应影响其父级和子级的状态。默认情况下,独立属性为false,这意味着当CheckBoxTreeItem对所选或不确定的属性进行状态更改时,相关的CheckBoxTreeItems的状态可能会被更改。 如果独立属性设置为true,则相关的CheckBoxTreeItems的状态将永远不会改变。
-
-
构造方法详细信息
-
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()
ABooleanProperty
用于表示此CheckBoxTreeItem的选定状态。- 结果
- 该CheckBoxTreeItem的选定状态属性
-
setIndeterminate
public final void setIndeterminate(boolean value)
设置此CheckBoxTreeItem的不确定状态。- 参数
-
value
- 此CheckBoxTreeItem的不确定状态
-
isIndeterminate
public final boolean isIndeterminate()
返回此CheckBoxTreeItem的不确定状态。- 结果
- 如果CheckBoxTreeItem是不确定状态,则为true
-
indeterminateProperty
public final BooleanProperty indeterminateProperty()
ABooleanProperty
用于表示此CheckBoxTreeItem的不确定状态。
-
independentProperty
public final BooleanProperty independentProperty()
ABooleanProperty
用于表示此CheckBoxTreeItem的独立状态。 独立状态用于表示对单个CheckBoxTreeItem的更改是否应影响其父级和子级的状态。默认情况下,独立属性为false,这意味着当CheckBoxTreeItem对所选或不确定的属性进行状态更改时,相关的CheckBoxTreeItems的状态可能会被更改。 如果独立属性设置为true,则相关的CheckBoxTreeItems的状态将永远不会改变。
-
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的状态将永远不会改变。
-
-