Детали свойства

• converter

  public final ObjectProperty<StringConverter<T>> converterProperty

  Свойство StringConverter.

  Возвращает:

  свойство StringConverter

Детали конструктора

• ChoiceBoxListCell

  public ChoiceBoxListCell()

  Создаёт ячейку ChoiceBoxListCell по умолчанию со списком элементов пустым.

• ChoiceBoxListCell

  @SafeVarargs
  public ChoiceBoxListCell​(T... items)

  Создаёт экземпляр ChoiceBoxListCell по умолчанию, используя заданные элементы для заполнения ChoiceBox при отображении.

  Параметры:

  items - Элементы, отображаемые в выпадающем меню ChoiceBox при выборе пользователем.

• ChoiceBoxListCell

  @SafeVarargs
  public ChoiceBoxListCell​(StringConverter<T> converter,
                           T... items)

  Создаёт экземпляр ChoiceBoxListCell с заданными элементами для заполнения ChoiceBox при отображении, и StringConverter для преобразования элемента в удобочитаемую форму.

  Параметры:

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

  items - Элементы, отображаемые в выпадающем меню ChoiceBox при выборе пользователем.

• ChoiceBoxListCell

  public ChoiceBoxListCell​(ObservableList<T> items)

  Создаёт экземпляр ChoiceBoxListCell по умолчанию, используя заданные элементы для заполнения ChoiceBox при отображении.

  Параметры:

  items - Элементы, отображаемые в выпадающем меню ChoiceBox при выборе пользователем.

• ChoiceBoxListCell

  public ChoiceBoxListCell​(StringConverter<T> converter,
                           ObservableList<T> items)

  Создаёт экземпляр ChoiceBoxListCell с заданными элементами для заполнения ChoiceBox при отображении, и StringConverter для преобразования элемента в удобочитаемую форму.

  Параметры:

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

  items - Элементы, отображаемые в выпадающем меню ChoiceBox при выборе пользователем.

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

• forListView

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

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

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

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

  Параметры:

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

  Возвращает:

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

• forListView

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

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

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

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

  Параметры:

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

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

  Возвращает:

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

• forListView

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

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

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

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

  Параметры:

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

  Возвращает:

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

• forListView

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

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

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

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

  Параметры:

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

  items - ObservableList содержащий ноль или более элементов, которые будут показаны пользователю, когда меню ChoiceBox отображается. Эти элементы должны быть того же типа, что и элементы списка 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 в этой ячейке

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

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

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

  Параметры:

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

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