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

• converter

  public final ObjectProperty<StringConverter<T>> converterProperty

  Свойство StringConverter.

  Возвращает:

  свойство StringConverter

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

• TextFieldTreeCell

  public TextFieldTreeCell()

  Создаёт стандартный TextFieldTreeCell с нулевым преобразователем. Без указанного StringConverter, эта ячейка не сможет принимать входные данные из TextField (так как она не будет знать, как преобразовать их обратно в объект домена). Поэтому настоятельно рекомендуется не использовать этот конструктор, если вы не планируете отдельно задать преобразователь.

• TextFieldTreeCell

  public TextFieldTreeCell​(StringConverter<T> converter)

  Создаёт TextFieldTreeCell, предоставляющий TextField при переходе в режим редактирования, что позволяет редактировать содержимое ячейки. Этот метод будет работать с любым экземпляром TreeView, независимо от его обобщённого типа. Однако для этого необходимо указать StringConverter, который преобразует введённую строку (из того, что ввёл пользователь) в экземпляр типа T. Этот элемент затем будет передан в обратный вызов TreeView.onEditCommitProperty().

  Параметры:

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

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

• forTreeView

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

  Предоставляет TextField, позволяющий редактировать содержимое ячейки при двойном щелчке по ячейке или вызове TreeView.edit(javafx.scene.control.TreeItem). Этот метод будет работать только с экземплярами TreeView типа String.

  Возвращает:

  Callback, который можно вставить в свойство cell factory property TreeView для включения текстового редактирования содержимого.

• forTreeView

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

  Предоставляет TextField, позволяющий редактировать содержимое ячейки при двойном щелчке по ячейке или вызове TreeView.edit(javafx.scene.control.TreeItem). Этот метод будет работать с любым экземпляром TreeView, независимо от его обобщённого типа. Однако для этого необходимо указать StringConverter, который преобразует введённую строку (из того, что ввёл пользователь) в экземпляр типа T. Этот элемент затем будет передан в обратный вызов TreeView.onEditCommitProperty().

  Тип параметров:

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

  Параметры:

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

  Возвращает:

  Callback, который можно вставить в свойство cell factory property 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 в этой ячейке

• startEdit

  public void startEdit()

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

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

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

• cancelEdit

  public void cancelEdit()

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

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

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

• updateItem

  public void updateItem​(T item,
                         boolean empty)

  Метод updateItem не должен вызываться разработчиками, но это лучший метод для переопределения разработчиками, чтобы позволить им настроить визуальные элементы ячейки. Для уточнения, разработчики никогда не должны вызывать этот метод в своём коде (они должны позволить элементу пользовательского интерфейса, такому как элемент управления 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 - указывает, представляет ли эта ячейка данные из списка. Если она пустая, значит она не представляет данные домена, а используется для рендеринга пустой строки.