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

• forListView

  @SafeVarargs
  public static <T> Callback<ListView<T>,​ListCell<T>> forListView​(T... items)

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

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

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

  Параметры:

  items - Ноль или более элементов, которые будут отображаться пользователю, когда меню ComboBox отображается. Эти элементы должны быть того же типа, что и список элементов ListView, чтобы при выборе они заменяли текущее значение в списке items.

  Возвращает:

  Объект Callback, который вернёт ячейку ListCell, способную работать с типом элемента, содержащегося в ListView.

• forListView

  @SafeVarargs
  public static <T> Callback<ListView<T>,​ListCell<T>> forListView​(StringConverter<T> converter,
                                                                        T... items)

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

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

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

  Параметры:

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

  items - Ноль или более элементов, которые будут отображаться пользователю, когда меню ComboBox отображается. Эти элементы должны быть того же типа, что и список элементов ListView, чтобы при выборе они заменяли текущее значение в списке items.

  Возвращает:

  Объект Callback, который вернёт ячейку ListCell, способную работать с типом элемента, содержащегося в ListView.

• forListView

  public static <T> Callback<ListView<T>,​ListCell<T>> forListView​(ObservableList<T> items)

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

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

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

  Параметры:

  items - Объект ObservableList, содержащий ноль или более элементов, которые будут отображаться пользователю, когда меню ComboBox отображается. Эти элементы должны быть того же типа, что и последовательность элементов ListView, чтобы при выборе они заменяли текущее значение в списке items.

  Возвращает:

  Объект Callback, который вернёт ячейку ListCell, способную работать с типом элемента, содержащегося в ListView.

• forListView

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

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

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

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

  Параметры:

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

  items - Объект ObservableList, содержащий ноль или более элементов, которые будут отображаться пользователю, когда меню ComboBox отображается. Эти элементы должны быть того же типа, что и последовательность элементов ListView, чтобы при выборе они заменяли текущее значение в списке items.

  Возвращает:

  Объект Callback, который вернёт ячейку ListCell, способную работать с типом элемента, содержащегося в 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, используемый в этой ячейке

• comboBoxEditableProperty

  public final BooleanProperty comboBoxEditableProperty()

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

  См. также:

  isComboBoxEditable(), setComboBoxEditable(boolean)

• setComboBoxEditable

  public final void setComboBoxEditable​(boolean value)

  Настраивает ComboBox для редактирования (чтобы разрешить ввод пользователем вне предложенных вариантов в раскрывающемся списке).

  Параметры:

  value - значение редактируемости для этого ComboBox

• isComboBoxEditable

  public final boolean isComboBoxEditable()

  Возвращает true, если ComboBox редактируется.

  Возвращает:

  true, если ComboBox редактируется

• getItems

  public ObservableList<T> getItems()

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

  Возвращает:

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

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

  Overrides:

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

  Параметры:

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

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