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

• converter

  public final ObjectProperty<StringConverter<T>> converterProperty

  Свойство StringConverter.

  Возвращает:

  свойство StringConverter

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

• TextFieldListCell

  public TextFieldListCell()

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

• TextFieldListCell

  public TextFieldListCell​(StringConverter<T> converter)

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

  Параметры:

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

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

• forListView

  public static Callback<ListView<String>,​ListCell<String>> forListView()

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

  Возвращает:

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

• forListView

  public static <T> Callback<ListView<T>,​ListCell<T>> forListView​(StringConverter<T> converter)

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

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

  T - Тип элемента, содержащегося в ячейке

  Параметры:

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

  Возвращает:

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

• 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 в классе ListCell<T>

• cancelEdit

  public void cancelEdit()

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

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

  cancelEdit в классе ListCell<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. Если мы этого не сделаем, почти наверняка пользователи увидят графические артефакты в ячейках неожиданно.

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

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

  Параметры:

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

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