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

• converter

  public final ObjectProperty<StringConverter<T>> converterProperty

  Свойство StringConverter.

  Возвращает:

  свойство StringConverter

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

• TextFieldTreeTableCell

  public TextFieldTreeTableCell()

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

• TextFieldTreeTableCell

  public TextFieldTreeTableCell​(StringConverter<T> converter)

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

  Параметры:

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

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

• forTreeTableColumn

  public static <S> Callback<TreeTableColumn<S,​String>,​TreeTableCell<S,​String>> forTreeTableColumn()

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

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

  S - Тип обобщенного типа TreeTableView

  Возвращает:

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

• forTreeTableColumn

  public static <S,​T> Callback<TreeTableColumn<S,​T>,​TreeTableCell<S,​T>> forTreeTableColumn​(StringConverter<T> converter)

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

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

  S - Тип обобщенного типа TreeTableView

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

  Параметры:

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

  Возвращает:

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

• 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 в классе TreeTableCell<S,​T>

• cancelEdit

  public void cancelEdit()

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

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

  cancelEdit в классе TreeTableCell<S,​T>

• updateItem

  public void updateItem​(T item,
                         boolean empty)

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

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

  updateItem в классе Cell<T>

  Параметры:

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

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