Class CheckBoxTreeItem<T>

TreeItem subclass that adds support for being in selected, unselected, and
indeterminate states. This is useful when used in conjunction with a TreeView
which has a CheckBoxTreeCell installed.

A CheckBoxTreeItem can be independent or
dependent. By default, CheckBoxTreeItem instances are dependent, which means
that any changes to the selection state of a TreeItem will have an impact on
parent and children CheckBoxTreeItem instances. If a CheckBoxTreeItem is
set to be independent, this means that any changes to that CheckBoxTreeItem
will not directly impact the state of parent and children CheckBoxTreeItem
instances.

The indeterminate property is used to
represent the same concept as that in CheckBox.indeterminateProperty(),
namely, that the CheckBox is neither selected or unselected. This is commonly
used inside a TreeView when some, but not all, of a branches children are
selected.

A simple example of using the CheckBoxTreeItem class, in conjunction with
CheckBoxTreeCell is shown below:

Creates a CheckBoxTreeItem with the value property set to the provided
object, the graphic set to the provided Node, the initial state
of the selectedProperty() set to the provided boolean value, and
the initial state of the independent
property to the provided boolean value.

independent

A BooleanProperty used to represent the independent state of this CheckBoxTreeItem.
The independent state is used to represent whether changes to a single
CheckBoxTreeItem should influence the state of its parent and children.

By default, the independent property is false, which means that when
a CheckBoxTreeItem has state changes to the selected or indeterminate
properties, the state of related CheckBoxTreeItems will possibly be changed.
If the independent property is set to true, the state of related CheckBoxTreeItems
will never change.

CheckBoxTreeItem

Creates a CheckBoxTreeItem with the value property set to the provided
object, the graphic set to the provided Node, the initial state
of the selectedProperty() set to the provided boolean value, and
the initial state of the independent
property to the provided boolean value.

Parameters:

value - The object to be stored as the value of this CheckBoxTreeItem.

graphic - The Node to show in the TreeView next to this CheckBoxTreeItem.

independentProperty

A BooleanProperty used to represent the independent state of this CheckBoxTreeItem.
The independent state is used to represent whether changes to a single
CheckBoxTreeItem should influence the state of its parent and children.

By default, the independent property is false, which means that when
a CheckBoxTreeItem has state changes to the selected or indeterminate
properties, the state of related CheckBoxTreeItems will possibly be changed.
If the independent property is set to true, the state of related CheckBoxTreeItems
will never change.

setIndependent

A BooleanProperty used to represent the independent state of this CheckBoxTreeItem.
The independent state is used to represent whether changes to a single
CheckBoxTreeItem should influence the state of its parent and children.

By default, the independent property is false, which means that when
a CheckBoxTreeItem has state changes to the selected or indeterminate
properties, the state of related CheckBoxTreeItems will possibly be changed.
If the independent property is set to true, the state of related CheckBoxTreeItems
will never change.

isIndependent

A BooleanProperty used to represent the independent state of this CheckBoxTreeItem.
The independent state is used to represent whether changes to a single
CheckBoxTreeItem should influence the state of its parent and children.

By default, the independent property is false, which means that when
a CheckBoxTreeItem has state changes to the selected or indeterminate
properties, the state of related CheckBoxTreeItems will possibly be changed.
If the independent property is set to true, the state of related CheckBoxTreeItems
will never change.