Подробности свойств

• converter

  public final ObjectProperty<StringConverter<T>> converterProperty

  Свойство StringConverter.

  Возвращает:

  свойство StringConverter

• selectedStateCallback

  public final ObjectProperty<Callback<T,​ObservableValue<Boolean>>> selectedStateCallbackProperty

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

  См. также:

  getSelectedStateCallback(), setSelectedStateCallback(Callback)

Подробности конструкторов

• CheckBoxListCell

  public CheckBoxListCell()

  Создаёт ячейку CheckBoxListCell по умолчанию.

• CheckBoxListCell

  public CheckBoxListCell​(Callback<T,​ObservableValue<Boolean>> getSelectedProperty)

  Создаёт ячейку CheckBoxListCell по умолчанию.

  Параметры:

  getSelectedProperty - Callback, возвращающий ObservableValue<Boolean> для элемента из ListView.

• CheckBoxListCell

  public CheckBoxListCell​(Callback<T,​ObservableValue<Boolean>> getSelectedProperty,
                          StringConverter<T> converter)

  Создаёт ячейку CheckBoxListCell с настраиваемым преобразователем строк.

  Параметры:

  getSelectedProperty - Callback, возвращающий ObservableValue<Boolean> для элемента из ListView.

  converter - StringConverter, преобразующий объект типа T в строку для визуального представления.

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

• forListView

  public static <T> Callback<ListView<T>,​ListCell<T>> forListView​(Callback<T,​ObservableValue<Boolean>> getSelectedProperty)

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

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

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

  Параметры:

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

  Возвращает:

  Callback, возвращающий ListCell, работающий с типом элементов списка ListView.

• forListView

  public static <T> Callback<ListView<T>,​ListCell<T>> forListView​(Callback<T,​ObservableValue<Boolean>> getSelectedProperty,
                                                                        StringConverter<T> converter)

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

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

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

  Параметры:

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

  converter - StringConverter, преобразующий объект типа T в строку для визуального представления.

  Возвращает:

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

• selectedStateCallbackProperty

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

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

  См. также:

  getSelectedStateCallback(), setSelectedStateCallback(Callback)

• setSelectedStateCallback

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

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

  Параметры:

  value - Callback

• getSelectedStateCallback

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

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

  Возвращает:

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

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

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

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

  Параметры:

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

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