Метод детали

• forTreeTableColumn

  @SafeVarargs
  public static <S,​T> Callback<TreeTableColumn<S,​T>,​TreeTableCell<S,​T>> forTreeTableColumn​(T... items)

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

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

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

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

  Параметры:

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

  Возвращает:

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

• forTreeTableColumn

  @SafeVarargs
  public static <S,​T> Callback<TreeTableColumn<S,​T>,​TreeTableCell<S,​T>> forTreeTableColumn​(StringConverter<T> converter,
                                                                                                                   T... items)

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

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

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

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

  Параметры:

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

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

  Возвращает:

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

• forTreeTableColumn

  public static <S,​T> Callback<TreeTableColumn<S,​T>,​TreeTableCell<S,​T>> forTreeTableColumn​(ObservableList<T> items)

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

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

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

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

  Параметры:

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

  Возвращает:

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

• forTreeTableColumn

  public static <S,​T> Callback<TreeTableColumn<S,​T>,​TreeTableCell<S,​T>> forTreeTableColumn​(StringConverter<T> converter,
                                                                                                                   ObservableList<T> items)

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

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

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

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

  Параметры:

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

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

  Возвращает:

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

• converterProperty

  public final ObjectProperty<StringConverter<T>> converterProperty()

  Свойство StringConverter.

  Возвращает:

  свойство преобразователя строк

• setConverter

  public final void setConverter​(StringConverter<T> value)

  Устанавливает StringConverter для использования в этой ячейке.

  Параметры:

  value - преобразователь строк

• getConverter

  public final StringConverter<T> getConverter()

  Возвращает 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 в классе TreeTableCell<S,​T>

• cancelEdit

  public void cancelEdit()

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

  Overrides:

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

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

  Overrides:

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

  Parameters:

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

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