Spec-Zone.ru › OpenJavaFX 8
javafx.scene.control

Класс CheckBoxTreeItem<T>

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

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

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
    A BooleanProperty используется для представления независимого состояния этого CheckBoxTreeItem.
    BooleanProperty indeterminate
    A BooleanProperty используется для представления неопределённого состояния этого CheckBoxTreeItem.
    BooleanProperty selected
    A 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()
    A BooleanProperty используется для представления независимого состояния этого CheckBoxTreeItem.
    BooleanProperty indeterminateProperty()
    A BooleanProperty используется для представления неопределённого состояния этого CheckBoxTreeItem.
    boolean isIndependent()
    Получает значение свойства independent.
    boolean isIndeterminate()
    Возвращает состояние неопределённости этого CheckBoxTreeItem.
    boolean isSelected()
    Возвращает состояние выбора этого CheckBoxTreeItem.
    BooleanProperty selectedProperty()
    A 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
      Объект BooleanProperty, используемый для представления выбранного состояния этого элемента CheckBoxTreeItem.

    • indeterminate

      public final BooleanProperty indeterminateProperty
      Объект BooleanProperty, используемый для представления неопределённого состояния этого элемента CheckBoxTreeItem.

      См. также:

      isIndeterminate(), setIndeterminate(boolean)

    • independent

      public final BooleanProperty independentProperty
      Объект BooleanProperty, используемый для представления независимого состояния этого элемента CheckBoxTreeItem. Независимое состояние указывает, будут ли изменения в одном элементе CheckBoxTreeItem влиять на состояние его родителя и дочерних элементов.

      По умолчанию свойство independent равно false, что означает, что при изменении состояния выбранного или неопределённого состояния элемента CheckBoxTreeItem, состояние связанных элементов CheckBoxTreeItem может быть изменено. Если свойство independent установлено в true, состояние связанных элементов CheckBoxTreeItem никогда не изменится.

      См. также:

      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.

    • CheckBoxTreeItem

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

      Параметры:

      value - Объект, который будет сохранён как значение этого элемента CheckBoxTreeItem.

    • CheckBoxTreeItem

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

      Параметры:

      value - Объект, который будет сохранён как значение этого элемента CheckBoxTreeItem.

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

    • 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) {
          ...     
     }
 });

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

      T - тип значения, содержащегося в элементе TreeItem.

    • setSelected

      public final void setSelected(boolean value)
      Устанавливает выбранное состояние этого элемента CheckBoxTreeItem.

    • isSelected

      public final boolean isSelected()
      Возвращает выбранное состояние этого элемента CheckBoxTreeItem.

    • selectedProperty

      public final BooleanProperty selectedProperty()
      Объект BooleanProperty, используемый для представления выбранного состояния этого элемента CheckBoxTreeItem.

    • setIndeterminate

      public final void setIndeterminate(boolean value)
      Устанавливает состояние неопределённости этого элемента CheckBoxTreeItem.

    • isIndeterminate

      public final boolean isIndeterminate()
      Возвращает состояние неопределённости этого элемента CheckBoxTreeItem.

    • indeterminateProperty

      public final BooleanProperty indeterminateProperty()
      Объект BooleanProperty, используемый для представления неопределённого состояния этого элемента CheckBoxTreeItem.

      См. также:

      isIndeterminate(), setIndeterminate(boolean)

    • independentProperty

      public final BooleanProperty independentProperty()
      Объект BooleanProperty, используемый для представления независимого состояния этого элемента CheckBoxTreeItem. Независимое состояние указывает, будут ли изменения в одном элементе CheckBoxTreeItem влиять на состояние его родителя и дочерних элементов.

      По умолчанию свойство independent равно false, что означает, что при изменении состояния выбранного или неопределённого состояния элемента CheckBoxTreeItem, состояние связанных элементов CheckBoxTreeItem может быть изменено. Если свойство independent установлено в true, состояние связанных элементов CheckBoxTreeItem никогда не изменится.

      См. также:

      isIndependent(), setIndependent(boolean)

    • setIndependent

      public final void setIndependent(boolean value)
      Устанавливает значение свойства independent.

      Описание свойства:

      Объект BooleanProperty, используемый для представления независимого состояния этого элемента CheckBoxTreeItem. Независимое состояние указывает, будут ли изменения в одном элементе CheckBoxTreeItem влиять на состояние его родителя и дочерних элементов.

      По умолчанию свойство independent равно false, что означает, что при изменении состояния выбранного или неопределённого состояния элемента CheckBoxTreeItem, состояние связанных элементов CheckBoxTreeItem может быть изменено. Если свойство independent установлено в true, состояние связанных элементов CheckBoxTreeItem никогда не изменится.

    • isIndependent

      public final boolean isIndependent()
      Получает значение свойства independent.

      Описание свойства:

      Объект BooleanProperty, используемый для представления независимого состояния этого элемента CheckBoxTreeItem. Независимое состояние указывает, будут ли изменения в одном элементе CheckBoxTreeItem влиять на состояние его родителя и дочерних элементов.

      По умолчанию свойство independent равно false, что означает, что при изменении состояния выбранного или неопределённого состояния элемента CheckBoxTreeItem, состояние связанных элементов CheckBoxTreeItem может быть изменено. Если свойство independent установлено в true, состояние связанных элементов CheckBoxTreeItem никогда не изменится.

© 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API