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

• forTreeView

  public static <T> Callback<TreeView<T>,​TreeCell<T>> forTreeView()

  Создаёт фабрику ячеек для использования в элементе управления TreeView, хотя при использовании в TreeView делается существенное предположение: эта фабрика ячеек предполагает, что корень TreeView и все дочерние элементы являются экземплярами CheckBoxTreeItem, а не стандартного класса TreeItem, который используется обычно.

  При использовании в TreeView ячейка CheckBox отображается с CheckBox справа от 'узла раскрытия' (т. е. стрелки). Элемент, хранящийся в TreeItem.getValue(), затем будет обработан StringConverter, и этот текст займёт всё оставшееся горизонтальное пространство. Кроме того, используя CheckBoxTreeItem, TreeView автоматически обрабатывает такие ситуации, как:

  • Нажатие на CheckBox рядом с элементом, имеющим дочерние элементы, приведёт к тому, что все дочерние элементы также будут выбраны/отменены.
  • Нажатие на CheckBox рядом с элементом, имеющим родителя, возможно, переключит состояние родителя. Например, если вы выберете единственного потомка, родитель станет неопределённым (указывая на частичный выбор потомков). Если вы продолжите выбор всех потомков, родитель также будет выбран. Это рекурсивно, со всеми родительскими узлами, обновляемыми как ожидается.

  К сожалению, из-за ограничений Java, при использовании этого метода необходимо явно выполнить приведение типов. Например:

   
   final TreeView<String> treeView = new TreeView<String>();
   treeView.setCellFactory(CheckBoxCell.<String>forTreeView());

  Type Parameters:

  T - Тип элементов, содержащихся в экземплярах CheckBoxTreeItem.

  Возвращает:

  А Callback, который вернёт TreeCell, способный работать с типом элемента, содержащегося в корне TreeView и всех его потомках (рекурсивно).

• forTreeView

  public static <T> Callback<TreeView<T>,​TreeCell<T>> forTreeView​(Callback<TreeItem<T>,​ObservableValue<Boolean>> getSelectedProperty)

  Создаёт фабрику ячеек для использования в элементе управления TreeView. В отличие от forTreeView(), этот метод не предполагает, что все экземпляры TreeItem в TreeView являются экземплярами CheckBoxTreeItem.

  При использовании в TreeView ячейка CheckBox отображается с CheckBox справа от 'узла раскрытия' (т. е. стрелки). Элемент, хранящийся в TreeItem.getValue(), затем будет обработан StringConverter, и этот текст займёт всё оставшееся горизонтальное пространство.

  В отличие от forTreeView(), эта фабрика ячеек не обрабатывает обновление состояния родительских или дочерних TreeItem — она просто переключает предоставленное ObservableValue<Boolean> и ничего больше. Конечно, эту функциональность можно реализовать внешне, добавив наблюдатели к ObservableValue<Boolean> и переключая состояние других свойств по мере необходимости.

  Type Parameters:

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

  Параметры:

  getSelectedProperty - Callback, который, получив объект типа TreeItem<T>, вернёт ObservableValue<Boolean>, представляющий собой выбран или нет данный элемент. Это ObservableValue<Boolean> будет привязано двунаправленно (что означает, что CheckBox в ячейке установит/сбросит это свойство в зависимости от взаимодействия пользователя, и CheckBox отобразит состояние ObservableValue<Boolean>, если оно изменится внешне).

  Возвращает:

  А Callback, который вернёт TreeCell, способный работать с типом элемента, содержащегося в корне TreeView и всех его потомках (рекурсивно).

• forTreeView

  public static <T> Callback<TreeView<T>,​TreeCell<T>> forTreeView​(Callback<TreeItem<T>,​ObservableValue<Boolean>> getSelectedProperty,
                                                                        StringConverter<TreeItem<T>> converter)

  Создаёт фабрику ячеек для использования в элементе управления TreeView. В отличие от forTreeView(), этот метод не предполагает, что все экземпляры TreeItem в TreeView являются экземплярами CheckBoxTreeItem.

  При использовании в TreeView ячейка CheckBox отображается с CheckBox справа от 'узла раскрытия' (т. е. стрелки). Элемент, хранящийся в TreeItem.getValue(), затем будет обработан StringConverter, и этот текст займёт всё оставшееся горизонтальное пространство.

  В отличие от forTreeView(), эта фабрика ячеек не обрабатывает обновление состояния родительских или дочерних TreeItems — она просто переключает предоставленное ObservableValue<Boolean> и ничего больше. Конечно, эту функциональность можно реализовать внешне, добавив наблюдатели к ObservableValue<Boolean> и переключая состояние других свойств по мере необходимости.

  Type Parameters:

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

  Параметры:

  getSelectedProperty - Callback, который, получив объект типа TreeItem<T>, вернёт ObservableValue<Boolean>, представляющий собой выбран или нет данный элемент. Это ObservableValue<Boolean> будет привязано двунаправленно (что означает, что CheckBox в ячейке установит/сбросит это свойство в зависимости от взаимодействия пользователя, и CheckBox отобразит состояние ObservableValue<Boolean>, если оно изменится внешне).

  converter - StringConverter, который, получив объект типа TreeItem<T>, вернёт строку, которая может быть использована для визуального представления объекта. По умолчанию в forTreeView(Callback) используется просто вызов .toString() для всех не нулевых элементов (и просто возвращается пустая строка в случае, если данный элемент равен null).

  Возвращает:

  А Callback, который вернёт TreeCell, способный работать с типом элемента, содержащегося в корне TreeView и всех его потомках (рекурсивно).

• converterProperty

  public final ObjectProperty<StringConverter<TreeItem<T>>> converterProperty()

  Свойство StringConverter.

  Возвращает:

  свойство StringConverter

• setConverter

  public final void setConverter​(StringConverter<TreeItem<T>> value)

  Устанавливает StringConverter для использования в этой ячейке.

  Параметры:

  value - StringConverter для использования в этой ячейке

• getConverter

  public final StringConverter<TreeItem<T>> getConverter()

  Возвращает StringConverter, используемый в этой ячейке.

  Возвращает:

  StringConverter, используемый в этой ячейке

• selectedStateCallbackProperty

  public final ObjectProperty<Callback<TreeItem<T>,​ObservableValue<Boolean>>> selectedStateCallbackProperty()

  Свойство, представляющее Callback, к которому привязана отображаемая на экране CheckBox.

  См. также:

  getSelectedStateCallback(), setSelectedStateCallback(Callback)

• setSelectedStateCallback

  public final void setSelectedStateCallback​(Callback<TreeItem<T>,​ObservableValue<Boolean>> value)

  Устанавливает Callback, к которому привязана отображаемая на экране CheckBox.

  Параметры:

  value - Callback, к которому привязана отображаемая на экране CheckBox

• getSelectedStateCallback

  public final Callback<TreeItem<T>,​ObservableValue<Boolean>> getSelectedStateCallback()

  Возвращает Callback, к которому привязана отображаемая на экране CheckBox.

  Возвращает:

  Callback, к которому привязана отображаемая на экране CheckBox

• updateItem

  public void updateItem​(T item,
                         boolean empty)

  Метод updateItem не должен вызываться разработчиками, но это лучший метод для переопределения, чтобы позволить настраивать визуализацию ячейки. Важно, чтобы разработчики никогда не вызывали этот метод в своём коде (они должны позволить управлению пользовательского интерфейса, например, элементу ListView, вызывать этот метод). Однако, метод updateItem нужен для того, чтобы разработчики при указании пользовательских фабрик ячеек (опять же, как в ListView cell factory), могли переопределить метод updateItem для полной настройки ячейки.

  Очень важно, чтобы подклассы Cell правильно переопределяли метод updateItem, так как невыполнение этого может привести к проблемам, таким как пустые ячейки или ячейки с неожиданным содержимым. Вот пример того, как правильно переопределить метод updateItem:

   protected void updateItem(T item, boolean empty) {
       super.updateItem(item, empty);
  
       if (empty || item == null) {
           setText(null);
           setGraphic(null);
       } else {
           setText(item.toString());
       }
   }
   

  Обратите внимание на два важных момента в этом примере кода:

  1. Мы вызываем метод super.updateItem(T, boolean). Если этого не сделать, свойства item и empty не будут правильно установлены, и у вас, вероятно, возникнут графические проблемы.
  2. Мы проверяем условие empty и, если оно истинно, устанавливаем свойства text и graphic в null. Если этого не сделать, почти гарантировано, что конечные пользователи увидят графические артефакты в ячейках неожиданно.

  Параметры:

  item - новый элемент для ячейки.

  empty - указывает, представляет ли эта ячейка данные из списка. Если она пуста, то она не представляет никакие данные домена, а используется для отрисовки пустой строки.