Методы

• forTreeView

  @SafeVarargs
  public static <T> Callback<TreeView<T>,​TreeCell<T>> forTreeView​(T... items)

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

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

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

  Параметры:

  items - Ноль или более элементов, которые будут отображаться пользователю при отображении меню ComboBox. Эти элементы должны быть того же типа, что и TreeView<T>, чтобы при выборе они заменяли текущее значение в свойстве TreeItem value.

  Возвращает:

  Объект Callback, возвращающий ячейку дерева, способную работать с типом элементов, содержащихся в TreeView.

• forTreeView

  public static <T> Callback<TreeView<T>,​TreeCell<T>> forTreeView​(ObservableList<T> items)

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

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

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

  Параметры:

  items - ObservableList, содержащий ноль или более элементов, которые будут отображаться пользователю при отображении меню ComboBox. Эти элементы должны быть того же типа, что и общий тип TreeView, таким образом, при выборе они заменяют текущее значение в TreeItem, который редактируется (как указано в TreeView.editingItemProperty().

  Возвращает:

  Объект Callback, возвращающий ячейку дерева, способную работать с типом элементов, содержащихся в TreeView.

• forTreeView

  @SafeVarargs
  public static <T> Callback<TreeView<T>,​TreeCell<T>> forTreeView​(StringConverter<T> converter,
                                                                        T... items)

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

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

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

  Параметры:

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

  items - Ноль или более элементов, которые будут отображаться пользователю при отображении меню ComboBox. Эти элементы должны быть того же типа, что и TreeView<T>, чтобы при выборе они заменяли текущее значение в свойстве TreeItem value.

  Возвращает:

  Объект Callback, возвращающий ячейку дерева, способную работать с типом элементов, содержащихся в TreeView.

• forTreeView

  public static <T> Callback<TreeView<T>,​TreeCell<T>> forTreeView​(StringConverter<T> converter,
                                                                        ObservableList<T> items)

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

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

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

  Параметры:

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

  items - ObservableList, содержащий ноль или более элементов, которые будут отображаться пользователю при отображении меню ComboBox. Эти элементы должны быть того же типа, что и общий тип TreeView, таким образом, при выборе они заменяют текущее значение в TreeItem, который редактируется (как указано в TreeView.editingItemProperty().

  Возвращает:

  Объект Callback, возвращающий ячейку дерева, способную работать с типом элементов, содержащихся в TreeView.

• 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 в этой ячейке

• 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 в классе TreeCell<T>

• cancelEdit

  public void cancelEdit()

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

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

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

  Параметры:

  item - Новое значение для ячейки.

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