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

• forTableColumn

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

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

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

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

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

  Параметры:

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

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

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

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

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

  Параметры:

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

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

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

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

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

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

  Параметры:

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

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

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

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

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

  Параметры:

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

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

• getItems

  public ObservableList<T> getItems()

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

  Возвращает:

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

• startEdit

  public void startEdit()

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

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

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

• cancelEdit

  public void cancelEdit()

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

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

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

• updateItem

  public void updateItem​(T item,
                         boolean empty)

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