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

• forTreeTableColumn

  public static <S> Callback<TreeTableColumn<S,​Boolean>,​TreeTableCell<S,​Boolean>> forTreeTableColumn​(TreeTableColumn<S,​Boolean> column)

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

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

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

  Type Parameters:

  S - Тип обобщённого типа TreeTableView

  Параметры:

  column - TreeTableColumn типа Boolean

  Возвращает:

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

• forTreeTableColumn

  public static <S,​T> Callback<TreeTableColumn<S,​T>,​TreeTableCell<S,​T>> forTreeTableColumn​(Callback<Integer,​ObservableValue<Boolean>> getSelectedProperty)

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

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

  Type Parameters:

  S - Тип обобщённого типа TreeTableView

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

  Параметры:

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

  Возвращает:

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

• forTreeTableColumn

  public static <S,​T> Callback<TreeTableColumn<S,​T>,​TreeTableCell<S,​T>> forTreeTableColumn​(Callback<Integer,​ObservableValue<Boolean>> getSelectedProperty,
                                                                                                                   boolean showLabel)

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

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

  Type Parameters:

  S - Тип обобщённого типа TreeTableView

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

  Параметры:

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

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

  Возвращает:

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

• forTreeTableColumn

  public static <S,​T> Callback<TreeTableColumn<S,​T>,​TreeTableCell<S,​T>> forTreeTableColumn​(Callback<Integer,​ObservableValue<Boolean>> getSelectedProperty,
                                                                                                                   StringConverter<T> converter)

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

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

  Type Parameters:

  S - Тип обобщённого типа TreeTableView

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

  Параметры:

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

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

  Возвращает:

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

• 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

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