Method Detail

• forTreeTableColumn

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

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

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

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

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

  Параметры:

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

  Возвращает:

  A Callback that will return a TreeTableCell that is able to work on the type of element contained within the TreeTableColumn.

• forTreeTableColumn

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

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

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

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

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

  Параметры:

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

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

  Возвращает:

  A Callback that will return a TreeTableCell that is able to work on the type of element contained within the TreeTableColumn.

• forTreeTableColumn

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

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

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

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

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

  Параметры:

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

  Возвращает:

  A Callback that will return a TreeTableCell that is able to work on the type of element contained within the TreeTableColumn.

• forTreeTableColumn

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

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

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

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

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

  Параметры:

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

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

  Возвращает:

  A Callback that will return a TreeTableCell that is able to work on the type of element contained within the 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, используемый в этой ячейке

• getItems

  public ObservableList<T> getItems()

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

  Возвращает:

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

• startEdit

  public void startEdit()

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

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

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

• cancelEdit

  public void cancelEdit()

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

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

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

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