Методы

• forTreeView

  @SafeVarargs
  public static <T> Callback<TreeView<T>,​TreeCell<T>> forTreeView​(T... items)

  Создаёт фабрику ячеек ChoiceBox для использования в элементах управления TreeView. По умолчанию, ячейка ChoiceBox отображается как Label при отсутствии редактирования и как ChoiceBox в режиме редактирования. ChoiceBox по умолчанию занимает всю ширину ячейки дерева.

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

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

  Параметры:

  items - Ноль или более элементов, которые будут отображены пользователю при отображении меню ChoiceBox. Эти элементы должны быть того же типа, что и TreeView<T>, чтобы при выборе они заменяли текущее значение в свойстве TreeItem value.

  Возвращает:

  A Callback, который вернёт ячейку дерева, способную работать с типом элементов, содержащихся в TreeView.

• forTreeView

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

  Создаёт фабрику ячеек ChoiceBox для использования в элементах управления TreeView. По умолчанию, ячейка ChoiceBox отображается как Label при отсутствии редактирования и как ChoiceBox в режиме редактирования. ChoiceBox по умолчанию занимает всю ширину ячейки дерева, за исключением места, выделенного для отступа ячейки дерева и узла раскрытия (т. е. стрелки).

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

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

  Параметры:

  items - ObservableList, содержащий ноль или более элементов, которые будут отображены пользователю при отображении меню ChoiceBox. Эти элементы должны быть того же типа, что и тип обобщения TreeView, чтобы при выборе они заменяли существующее значение в TreeItem, который редактируется (как указано в TreeView.editingItemProperty()).

  Возвращает:

  A Callback, который вернёт ячейку дерева, способную работать с типом элементов, содержащихся в TreeView.

• forTreeView

  @SafeVarargs
  public static <T> Callback<TreeView<T>,​TreeCell<T>> forTreeView​(StringConverter<T> converter,
                                                                        T... items)

  Создаёт фабрику ячеек ChoiceBox для использования в элементах управления TreeView. По умолчанию, ячейка ChoiceBox отображается как Label при отсутствии редактирования и как ChoiceBox в режиме редактирования. ChoiceBox по умолчанию занимает всю ширину ячейки дерева.

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

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

  Параметры:

  converter - StringConverter для преобразования заданного элемента (типа T) в строку для отображения пользователю.

  items - Ноль или более элементов, которые будут отображены пользователю при отображении меню ChoiceBox. Эти элементы должны быть того же типа, что и TreeView<T>, чтобы при выборе они заменяли текущее значение в свойстве TreeItem value.

  Возвращает:

  A Callback, который вернёт ячейку дерева, способную работать с типом элементов, содержащихся в TreeView.

• forTreeView

  public static <T> Callback<TreeView<T>,​TreeCell<T>> forTreeView​(StringConverter<T> converter,
                                                                        ObservableList<T> items)

  Создаёт фабрику ячеек ChoiceBox для использования в элементах управления TreeView. По умолчанию, ячейка ChoiceBox отображается как Label при отсутствии редактирования и как ChoiceBox в режиме редактирования. ChoiceBox по умолчанию занимает всю ширину ячейки дерева.

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

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

  Параметры:

  converter - StringConverter для преобразования заданного элемента (типа T) в строку для отображения пользователю.

  items - ObservableList, содержащий ноль или более элементов, которые будут отображены пользователю при отображении меню ChoiceBox. Эти элементы должны быть того же типа, что и тип обобщения TreeView, чтобы при выборе они заменяли существующее значение в TreeItem, который редактируется (как указано в TreeView.editingItemProperty()).

  Возвращает:

  A Callback, который вернёт ячейку дерева, способную работать с типом элементов, содержащихся в TreeView.

• converterProperty

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

  Свойство StringConverter.

  Возвращает:

  свойство StringConverter

• setConverter

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

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

  Параметры:

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

• getConverter

  public final StringConverter<T> getConverter()

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

  Возвращает:

  используемый StringConverter

• getItems

  public ObservableList<T> getItems()

  Возвращает элементы, которые будут отображаться в ChoiceBox при её отображении.

  Возвращает:

  элементы, которые будут отображаться в ChoiceBox при её отображении

• startEdit

  public void startEdit()

  Вызовите эту функцию, чтобы перейти из состояния без редактирования в состояние редактирования, если ячейка редактируема. Если эта ячейка уже находится в состоянии редактирования, она останется в нём.

  Переопределяет:

  startEdit в классе TreeCell<T>

• cancelEdit

  public void cancelEdit()

  Вызовите эту функцию, чтобы перейти из состояния редактирования в состояние без редактирования, не сохраняя введённые пользователем данные.

  Переопределяет:

  cancelEdit в классе TreeCell<T>

• updateItem

  public void updateItem​(T item,
                         boolean empty)

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

  Очень важно, чтобы подклассы Cell корректно переопределяли метод 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 - указывает, представляет ли данная ячейка данные из списка. Если она пустая, то она не представляет данные домена, а используется для отображения пустой строки.