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

• forTableColumn

  @SafeVarargs
  public static <S,​T> Callback<TableColumn<S,​T>,​TableCell<S,​T>> forTableColumn​(T... items)

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

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

  S - тип универсального типа TableView

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

  Параметры:

  items - Ноль или более элементов, которые будут показаны пользователю, когда меню ComboBox отображается. Эти элементы должны быть того же типа, что и TableColumn. Обратите внимание, что разработчик должен установить event handlers для прослушивания событий редактирования в TableColumn и реагировать соответствующим образом. Методы, представляющие интерес, включают setOnEditStart, setOnEditCommit и setOnEditCancel.

  Возвращает:

  A Callback, который вернёт TableCell, способный работать с типом элемента, содержащегося в TableColumn.

• forTableColumn

  @SafeVarargs
  public static <S,​T> Callback<TableColumn<S,​T>,​TableCell<S,​T>> forTableColumn​(StringConverter<T> converter,
                                                                                                       T... items)

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

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

  S - тип универсального типа TableView

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

  Параметры:

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

  items - Ноль или более элементов, которые будут показаны пользователю, когда меню ComboBox отображается. Эти элементы должны быть того же типа, что и TableColumn. Обратите внимание, что разработчик должен установить event handlers для прослушивания событий редактирования в TableColumn и реагировать соответствующим образом. Методы, представляющие интерес, включают setOnEditStart, setOnEditCommit и setOnEditCancel.

  Возвращает:

  A Callback, который вернёт TableCell, способный работать с типом элемента, содержащегося в TableColumn.

• forTableColumn

  public static <S,​T> Callback<TableColumn<S,​T>,​TableCell<S,​T>> forTableColumn​(ObservableList<T> items)

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

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

  S - тип универсального типа TableView

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

  Параметры:

  items - Ноль или более элементов, которые будут показаны пользователю, когда меню ComboBox отображается. Эти элементы должны быть того же типа, что и TableColumn. Обратите внимание, что разработчик должен установить event handlers для прослушивания событий редактирования в TableColumn и реагировать соответствующим образом. Методы, представляющие интерес, включают setOnEditStart, setOnEditCommit и setOnEditCancel.

  Возвращает:

  A Callback, который вернёт TableCell, способный работать с типом элемента, содержащегося в TableColumn.

• forTableColumn

  public static <S,​T> Callback<TableColumn<S,​T>,​TableCell<S,​T>> forTableColumn​(StringConverter<T> converter,
                                                                                                       ObservableList<T> items)

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

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

  S - тип универсального типа TableView

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

  Параметры:

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

  items - Ноль или более элементов, которые будут показаны пользователю, когда меню ComboBox отображается. Эти элементы должны быть того же типа, что и TableColumn. Обратите внимание, что разработчик должен установить event handlers для прослушивания событий редактирования в TableColumn и реагировать соответствующим образом. Методы, представляющие интерес, включают setOnEditStart, setOnEditCommit и setOnEditCancel.

  Возвращает:

  A Callback, который вернёт TableCell, способный работать с типом элемента, содержащегося в TableColumn.

• 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()

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

  Возвращает:

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

• startEdit

  public void startEdit()

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

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

  startEdit в классе TableCell<S,​T>

• cancelEdit

  public void cancelEdit()

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

  Overrides:

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

• updateItem

  public void updateItem​(T item,
                         boolean empty)

  Метод updateItem не должен вызываться разработчиками, но это лучший метод для переопределения разработчиками, чтобы позволить им настраивать визуальные элементы ячейки. Для уточнения, разработчики никогда не должны вызывать этот метод в своём коде (они должны позволить элементу управления пользовательского интерфейса, например, элементу управления ListView, вызвать этот метод). Однако назначение метода updateItem состоит в том, чтобы разработчики при указании пользовательских фабрик ячеек (снова, например, ListView cell factory) могли переопределить метод updateItem, чтобы разрешить полную настройку ячейки.

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

  Overrides:

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

  Параметры:

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

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