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

• forTableColumn

  public static <S> Callback<TableColumn<S,​Boolean>,​TableCell<S,​Boolean>> forTableColumn​(TableColumn<S,​Boolean> column)

  Создаёт фабрику ячеек для использования в фабрике ячеек TableColumn. Этот метод требует, чтобы столбец TableColumn был типа Boolean.

  При использовании в TableColumn CheckBoxCell отображается с CheckBox, центрированным в столбце.

  ObservableValue<Boolean>, содержащиеся в каждой ячейке столбца, будут связаны двунаправленно. Это означает, что CheckBox в ячейке будет устанавливать/снимать этот параметр на основе пользовательских взаимодействий, и CheckBox будет отражать состояние ObservableValue<Boolean>, если оно изменится внешним образом).

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

  S - Тип дженерического типа TableView

  Параметры:

  column - TableColumn типа Boolean

  Возвращает:

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

• forTableColumn

  public static <S,​T> Callback<TableColumn<S,​T>,​TableCell<S,​T>> forTableColumn​(Callback<Integer,​ObservableValue<Boolean>> getSelectedProperty)

  Создаёт фабрику ячеек для использования в фабрике ячеек TableColumn. Этот метод требует, чтобы столбец TableColumn был типа ObservableValue<Boolean>.

  При использовании в TableColumn CheckBoxCell отображается с CheckBox, центрированным в столбце.

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

  S - Тип дженерического типа TableView

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

  Параметры:

  getSelectedProperty - A Callback, который, получив объект типа TableColumn<S,T>, вернёт ObservableValue<Boolean>, представляющий, выбран ли данный элемент. Этот ObservableValue<Boolean> будет связан двунаправленно (это означает, что CheckBox в ячейке будет устанавливать/снимать этот параметр на основе пользовательских взаимодействий, и CheckBox будет отражать состояние ObservableValue<Boolean>, если оно изменится внешним образом).

  Возвращает:

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

• forTableColumn

  public static <S,​T> Callback<TableColumn<S,​T>,​TableCell<S,​T>> forTableColumn​(Callback<Integer,​ObservableValue<Boolean>> getSelectedProperty,
                                                                                                       boolean showLabel)

  Создаёт фабрику ячеек для использования в фабрике ячеек TableColumn. Этот метод требует, чтобы столбец TableColumn был типа ObservableValue<Boolean>.

  При использовании в TableColumn CheckBoxCell отображается с CheckBox, центрированным в столбце.

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

  S - Тип дженерического типа TableView

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

  Параметры:

  getSelectedProperty - A Callback, который, получив объект типа TableColumn<S,T>, вернёт ObservableValue<Boolean>, представляющий, выбран ли данный элемент. Этот ObservableValue<Boolean> будет связан двунаправленно (это означает, что CheckBox в ячейке будет устанавливать/снимать этот параметр на основе пользовательских взаимодействий, и CheckBox будет отражать состояние ObservableValue<Boolean>, если оно изменится внешним образом).

  showLabel - В некоторых случаях может потребоваться отобразить метку в TableCell рядом с CheckBox. По умолчанию метка не отображается, но если установить это значение в true, в ячейке также будет вызван метод toString() для элемента. Если такое поведение нежелательно, рассмотрите использование forTableColumn(javafx.util.Callback, javafx.util.StringConverter), которое позволяет предоставить callback, определяющий метку для заданного элемента строки.

  Возвращает:

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

• forTableColumn

  public static <S,​T> Callback<TableColumn<S,​T>,​TableCell<S,​T>> forTableColumn​(Callback<Integer,​ObservableValue<Boolean>> getSelectedProperty,
                                                                                                       StringConverter<T> converter)

  Создаёт фабрику ячеек для использования в фабрике ячеек TableColumn. Этот метод требует, чтобы столбец TableColumn был типа ObservableValue<Boolean>.

  При использовании в TableColumn CheckBoxCell отображается с CheckBox, центрированным в столбце.

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

  S - Тип дженерического типа TableView

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

  Параметры:

  getSelectedProperty - A Callback, который, получив объект типа TableColumn<S,T>, вернёт ObservableValue<Boolean>, представляющий, выбран ли данный элемент. Этот ObservableValue<Boolean> будет связан двунаправленно (это означает, что CheckBox в ячейке будет устанавливать/снимать этот параметр на основе пользовательских взаимодействий, и CheckBox будет отражать состояние ObservableValue<Boolean>, если оно изменится внешним образом).

  converter - A StringConverter, который, получив объект типа T, вернёт строку, которая может быть использована для визуального представления объекта. По умолчанию в forTableColumn(Callback, boolean) (когда showLabel true) - это просто вызов .toString() для всех ненулевых элементов (и возвращение пустой строки в случаях, когда заданный элемент равен null).

  Возвращает:

  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, используемый в этой ячейке

• selectedStateCallbackProperty

  public final ObjectProperty<Callback<Integer,​ObservableValue<Boolean>>> selectedStateCallbackProperty()

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

  См. также:

  getSelectedStateCallback(), setSelectedStateCallback(Callback)

• setSelectedStateCallback

  public final void setSelectedStateCallback​(Callback<Integer,​ObservableValue<Boolean>> value)

  Устанавливает Callback, к которому привязана CheckBox, отображаемая на экране.

  Параметры:

  value - Callback, к которому привязана CheckBox, отображаемая на экране

• getSelectedStateCallback

  public final Callback<Integer,​ObservableValue<Boolean>> getSelectedStateCallback()

  Возвращает Callback, к которому привязана CheckBox, отображаемая на экране.

  Возвращает:

  Callback, к которому привязана CheckBox, отображаемая на экране

• updateItem

  public void updateItem​(T item,
                         boolean empty)

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

  Очень важно, чтобы подклассы Cell надлежащим образом переопределяли метод 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). Если этого не сделать, свойства элемента и пустоты не будут правильно установлены, и у вас, вероятно, возникнут графические проблемы.
  2. Мы проверяем условие empty, и если оно истинно, мы устанавливаем свойства текста и графики в null. Если этого не сделать, с высокой вероятностью конечные пользователи увидят графические артефакты в ячейках неожиданным образом.

  Overrides:

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

  Параметры:

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

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