CheckBoxTreeItem

java.lang.Object
- javafx.scene.control.TreeItem<T>
- - javafx.scene.control.CheckBoxTreeItem<T>

Параметры типа:

T - Тип значения, содержащегося в TreeItem

Все реализованные интерфейсы:

EventTarget
```
public class CheckBoxTreeItem<T>
extends TreeItem<T>
```
Подкласс TreeItem, который добавляет поддержку состояний выбранного, невыбранного и неопределенного. Это полезно при использовании с TreeView, в котором установлен CheckBoxTreeCell.
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

Краткое описание свойств

Свойства
Тип	Свойство	Описание
`BooleanProperty`	`independent`	`BooleanProperty` используется для представления независимого состояния CheckBoxTreeItem.
`BooleanProperty`	`indeterminate`	`BooleanProperty` используется для представления состояния неопределённости CheckBoxTreeItem.
`BooleanProperty`	`selected`	`BooleanProperty` используется для представления состояния выбора CheckBoxTreeItem.

Свойства, унаследованные от класса javafx.scene.control.TreeItem
expanded, graphic, leaf, parent, value

Краткое описание вложенных классов

Вложенные классы
Модификатор и тип	Класс	Описание
`static class`	`CheckBoxTreeItem.TreeModificationEvent<T>`	Класс TreeModificationEvent, работающий аналогично классу `TreeItem.TreeModificationEvent`, при этом это событие будет подниматься по иерархии CheckBoxTreeItem до тех пор, пока родительский узел не станет null.

Краткое описание конструкторов

Конструкторы
Конструктор	Описание
`CheckBoxTreeItem()`	Создаёт пустой CheckBoxTreeItem.
`CheckBoxTreeItem(T value)`	Создаёт CheckBoxTreeItem со значением свойства value, установленным в предоставленный объект.
`CheckBoxTreeItem(T value, Node graphic)`	Создаёт CheckBoxTreeItem со значением свойства value, установленным в предоставленный объект, и графическим элементом, установленным в предоставленный Node.
`CheckBoxTreeItem(T value, Node graphic, boolean selected)`	Создаёт CheckBoxTreeItem со значением свойства value, установленным в предоставленный объект, графическим элементом, установленным в предоставленный Node, и начальным состоянием свойства `selectedProperty()`, установленным в предоставленное логическое значение.
`CheckBoxTreeItem(T value, Node graphic, boolean selected, boolean independent)`	Создаёт CheckBoxTreeItem со значением свойства value, установленным в предоставленный объект, графическим элементом, установленным в предоставленный Node, начальным состоянием свойства `selectedProperty()`, установленным в предоставленное логическое значение, и начальным состоянием свойства `independent`, установленным в предоставленное логическое значение.

Краткое описание методов

Все методыСтатические методыМетоды экземпляраКонкретные методы
Модификатор и тип	Метод	Описание
`static <T> EventType<CheckBoxTreeItem.TreeModificationEvent<T>>`	`checkBoxSelectionChangedEvent()`	Тип события, используемый при изменении состояния выбора/неопределённости CheckBoxTreeItem.
`BooleanProperty`	`independentProperty()`	`BooleanProperty` используется для представления независимого состояния CheckBoxTreeItem.
`BooleanProperty`	`indeterminateProperty()`	`BooleanProperty` используется для представления состояния неопределённости CheckBoxTreeItem.
`boolean`	`isIndependent()`	Возвращает значение свойства independent.
`boolean`	`isIndeterminate()`	Возвращает состояние неопределённости CheckBoxTreeItem.
`boolean`	`isSelected()`	Возвращает состояние выбора CheckBoxTreeItem.
`BooleanProperty`	`selectedProperty()`	`BooleanProperty` используется для представления состояния выбора CheckBoxTreeItem.
`void`	`setIndependent(boolean value)`	Устанавливает значение свойства independent.
`void`	`setIndeterminate(boolean value)`	Устанавливает состояние неопределённости CheckBoxTreeItem.
`void`	`setSelected(boolean value)`	Устанавливает состояние выбора CheckBoxTreeItem.

Методы, унаследованные от класса 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

Методы, унаследованные от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробности свойств
- selected
```
public final BooleanProperty selectedProperty
```
  A BooleanProperty используется для представления выбранного состояния этого CheckBoxTreeItem.
  
  Возвращает:
  
  свойство выбранного состояния этого CheckBoxTreeItem
- indeterminate
```
public final BooleanProperty indeterminateProperty
```
  A BooleanProperty используется для представления неопределённого состояния этого CheckBoxTreeItem.
  
  См. также:
  
  isIndeterminate(), setIndeterminate(boolean)
- independent
```
public final BooleanProperty independentProperty
```
  A BooleanProperty используется для представления независимого состояния этого CheckBoxTreeItem. Независимое состояние используется для указания, должны ли изменения одного CheckBoxTreeItem влиять на состояние его родителя и дочерних элементов.
  По умолчанию, свойство independent равно false, что означает, что при изменении состояния выбранного или неопределённого CheckBoxTreeItem состояние связанных CheckBoxTreeItems может быть изменено. Если свойство independent установлено в 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, установленным на предоставленный объект, и графическим элементом, установленным на предоставленный Node.
  
  Параметры:
  
  value - Объект, который будет храниться в качестве значения этого CheckBoxTreeItem.
  
  graphic - Node, который будет отображаться в TreeView рядом с этим CheckBoxTreeItem.
- CheckBoxTreeItem
```
public CheckBoxTreeItem(T value,
                        Node graphic,
                        boolean selected)
```
  Создаёт CheckBoxTreeItem со свойством value, установленным на предоставленный объект, графическим элементом, установленным на предоставленный Node, и начальным состоянием selectedProperty(), установленным на предоставленное булевое значение.
  
  Параметры:
  
  value - Объект, который будет храниться в качестве значения этого CheckBoxTreeItem.
  
  graphic - Node, который будет отображаться в TreeView рядом с этим CheckBoxTreeItem.
  
  selected - Начальное значение свойства selected.
- CheckBoxTreeItem
```
public CheckBoxTreeItem(T value,
                        Node graphic,
                        boolean selected,
                        boolean independent)
```
  Создаёт CheckBoxTreeItem со свойством value, установленным на предоставленный объект, графическим элементом, установленным на предоставленный Node, начальным состоянием selectedProperty(), установленным на предоставленное булевое значение, и начальным состоянием свойства independent, установленным на предоставленное булевое значение.
  
  Параметры:
  
  value - Объект, который будет храниться в качестве значения этого CheckBoxTreeItem.
  
  graphic - Node, который будет отображаться в TreeView рядом с этим CheckBoxTreeItem.
  
  selected - Начальное значение свойства selected.
  
  independent - Начальное значение свойства independent.

Подробности методов
- checkBoxSelectionChangedEvent
```
public static <T> EventType<CheckBoxTreeItem.TreeModificationEvent<T>> checkBoxSelectionChangedEvent()
```
  Тип события, используемый при изменении состояния выбора/неопределённости CheckBoxTreeItem. Для использования рекомендуется использовать код следующего вида:
```
 
 child1.addEventHandler(CheckBoxTreeItem.<String>checkBoxSelectionChangedEvent(), new EventHandler<TreeModificationEvent<String>>() {
     public void handle(TreeModificationEvent<String> event) {
          ...
     }
 });
 
```
  Type Parameters:
  
  T - Тип значения, содержащегося в TreeItem.
  
  Возвращает:
  
  Тип события, используемый при изменении состояния выбора/неопределённости CheckBoxTreeItem
- setSelected
```
public final void setSelected(boolean value)
```
  Устанавливает состояние выбора этого CheckBoxTreeItem.
  
  Параметры:
  
  value - Состояние выбора этого CheckBoxTreeItem
- isSelected
```
public final boolean isSelected()
```
  Возвращает состояние выбора этого CheckBoxTreeItem.
  
  Возвращает:
  
  true, если CheckBoxTreeItem выбран, иначе false
- 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.
  
  Возвращает:
  
  true, если CheckBoxTreeItem в состоянии неопределённости, иначе false
- indeterminateProperty
```
public final BooleanProperty indeterminateProperty()
```
  A BooleanProperty используется для представления неопределённого состояния этого CheckBoxTreeItem.
  
  См. также:
  
  isIndeterminate(), setIndeterminate(boolean)
- independentProperty
```
public final BooleanProperty independentProperty()
```
  A BooleanProperty используется для представления независимого состояния этого CheckBoxTreeItem. Независимое состояние используется для указания, должны ли изменения одного CheckBoxTreeItem влиять на состояние его родителя и дочерних элементов.
  По умолчанию, свойство independent равно false, что означает, что при изменении состояния выбранного или неопределённого CheckBoxTreeItem состояние связанных CheckBoxTreeItems может быть изменено. Если свойство independent установлено в true, состояние связанных CheckBoxTreeItems никогда не будет изменено.
  
  См. также:
  
  isIndependent(), setIndependent(boolean)
- setIndependent
```
public final void setIndependent(boolean value)
```
  Устанавливает значение свойства independent.
  
  Описание свойства:
  
  A BooleanProperty используется для представления независимого состояния этого CheckBoxTreeItem. Независимое состояние используется для указания, должны ли изменения одного CheckBoxTreeItem влиять на состояние его родителя и дочерних элементов.
  По умолчанию, свойство independent равно false, что означает, что при изменении состояния выбранного или неопределённого CheckBoxTreeItem состояние связанных CheckBoxTreeItems может быть изменено. Если свойство independent установлено в true, состояние связанных CheckBoxTreeItems никогда не будет изменено.
- isIndependent
```
public final boolean isIndependent()
```
  Возвращает значение свойства independent.
  
  Описание свойства:
  
  A BooleanProperty используется для представления независимого состояния этого CheckBoxTreeItem. Независимое состояние используется для указания, должны ли изменения одного CheckBoxTreeItem влиять на состояние его родителя и дочерних элементов.
  По умолчанию, свойство independent равно false, что означает, что при изменении состояния выбранного или неопределённого CheckBoxTreeItem состояние связанных CheckBoxTreeItems может быть изменено. Если свойство independent установлено в true, состояние связанных CheckBoxTreeItems никогда не будет изменено.

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Класс CheckBoxTreeItem<T>

Краткое описание свойств

Свойства, унаследованные от класса javafx.scene.control.TreeItem

Краткое описание вложенных классов

Краткое описание конструкторов

Краткое описание методов

Методы, унаследованные от класса javafx.scene.control.TreeItem

Методы, унаследованные от класса java.lang.Object

Подробности свойств

selected

indeterminate

independent

Подробности конструкторов

CheckBoxTreeItem

CheckBoxTreeItem

CheckBoxTreeItem

CheckBoxTreeItem

Подробности методов

checkBoxSelectionChangedEvent

setSelected

isSelected

selectedProperty

setIndeterminate

isIndeterminate

indeterminateProperty

independentProperty

setIndependent

isIndependent