Класс TreeTableColumn<S,T>

java.lang.Object

javafx.scene.control.TableColumnBase<TreeItem<S>,T>

javafx.scene.control.TreeTableColumn<S,T>

Type Parameters:: S - Тип дженерик-типа TableView (т.е. S == TableView<S>); T - Тип содержимого во всех ячейках в этом столбце.

Все реализуемые интерфейсы:: Styleable, EventTarget

public class TreeTableColumn<S,T> extends TableColumnBase<TreeItem<S>,T> implements EventTarget

Дерево TreeTableView состоит из нескольких экземпляров TreeTableColumn. Каждый TreeTableColumn в TreeTableView отвечает за отображение (и редактирование) содержимого этого столбца. Помимо отображения и редактирования данных для одного столбца, TreeTableColumn также содержит необходимые свойства для:

Изменения размера (используя minWidth/ prefWidth/ maxWidth и width свойства)
Включения/выключения видимости с помощью visibility
Отображения header text
Отображения любых nested columns, которые могут быть в нём
Наличие контекстного меню context menu при щелчке правой кнопкой мыши на области заголовка столбца
Сортировка содержимого таблицы (с использованием comparator, sortable и sortType)

При создании экземпляра TreeTableColumn, пожалуй, наиболее важными свойствами для настройки являются текст столбца text (что отображать в области заголовка столбца) и значение ячейки столбца cell value factory (которое используется для заполнения отдельных ячеек в столбце). Это можно сделать с помощью варианта следующего кода:


 firstNameCol.setCellValueFactory(new Callback<CellDataFeatures<Person, String>, ObservableValue<String>>() {
     public ObservableValue<String> call(CellDataFeatures<Person, String> p) {
         // p.getValue() returns the TreeItem<Person> instance for a particular TreeTableView row,
         // p.getValue().getValue() returns the Person instance inside the TreeItem<Person>
         return p.getValue().getValue().firstNameProperty();
     }
  });
 }

Этот подход предполагает, что объект, возвращаемый от p.getValue().getValue(), имеет JavaFX ObservableValue, который можно просто вернуть. Преимущество этого состоит в том, что TableView внутренне создаст привязки, чтобы, в случае изменения возвращаемого ObservableValue, содержимое ячейки автоматически обновлялось.

В ситуациях, когда TableColumn должен взаимодействовать с классами, созданными до JavaFX, или которые вообще не хотят использовать API JavaFX для свойств, можно обернуть возвращаемое значение в экземпляр ReadOnlyObjectWrapper. Например:


 firstNameCol.setCellValueFactory(new Callback<CellDataFeatures<Person, String>, ObservableValue<String>>() {
     public ObservableValue<String> call(CellDataFeatures<Person, String> p) {
         // p.getValue() returns the TreeItem<Person> instance for a particular TreeTableView row,
         // p.getValue().getValue() returns the Person instance inside the TreeItem<Person>
         return new ReadOnlyObjectWrapper(p.getValue().getValue().getFirstName());
     }
  });
 }

Надеемся, что со временем будут разработаны и предоставлены удобные фабрики для значений ячеек. По состоянию на релиз JavaFX 2.0 существует один такой класс: TreeItemPropertyValueFactory. Этот класс избавляет от необходимости писать приведенный выше код, вместо этого полагаясь на рефлексию для поиска заданного свойства по строке. Обратитесь к документации класса TreeItemPropertyValueFactory для получения более подробной информации о том, как использовать его со столбцом. Наконец, более подробная информация о том, как использовать TableColumn, содержится в документации класса TableView.

С момента:

JavaFX 8.0

См. также:

Резюме свойств

Тип	Свойство	Описание
`final ObjectProperty<Callback<TreeTableColumn<S,T>,TreeTableCell<S,T>>>`	`cellFactory`	Фабрика ячеек для всех ячеек в этом столбце.
`final ObjectProperty<Callback<TreeTableColumn.CellDataFeatures<S,T>,ObservableValue<T>>>`	`cellValueFactory`	Фабрика значений ячеек должна быть установлена для указания способа заполнения всех ячеек в одном TreeTableColumn.
`final ObjectProperty<EventHandler<TreeTableColumn.CellEditEvent<S,T>>>`	`onEditCancel`	Этот обработчик событий будет вызван, когда пользователь отменит редактирование ячейки.
`final ObjectProperty<EventHandler<TreeTableColumn.CellEditEvent<S,T>>>`	`onEditCommit`	Этот обработчик событий будет вызван, когда пользователь успешно подтвердит редактирование.
`final ObjectProperty<EventHandler<TreeTableColumn.CellEditEvent<S,T>>>`	`onEditStart`	Этот обработчик событий будет вызван, когда пользователь успешно инициирует редактирование.
`final ObjectProperty<TreeTableColumn.SortType>`	`sortType`	Указывает, должен ли этот столбец (если он входит в порядок сортировки, см. `TreeTableView.getSortOrder()` для получения более подробной информации) сортироваться по возрастанию или убыванию.
`final ReadOnlyObjectProperty<TreeTableView<S>>`	`treeTableView`	TreeTableView, к которому принадлежит этот TreeTableColumn.

Свойства, объявленные в классе javafx.scene.control.TableColumnBase

comparator, contextMenu, editable, graphic, id, maxWidth, minWidth, parentColumn, prefWidth, reorderable, resizable, sortable, sortNode, style, text, visible, width

Резюме вложенных классов

Модификатор и тип	Класс	Описание
`static class`	`TreeTableColumn.CellDataFeatures<S,T>`	Вспомогательный класс, используемый в TreeTableColumn в качестве оберточного класса для предоставления всей необходимой информации для конкретной `Cell`.
`static class`	`TreeTableColumn.CellEditEvent<S,T>`	Событие, которое срабатывает, когда пользователь выполняет редактирование в ячейке таблицы.
`static enum`	`TreeTableColumn.SortType`	Перечисление, определяющее тип сортировки, применяемой к конкретному столбцу.

Резюме полей

Модификатор и тип	Поле	Описание
`static final Callback<TreeTableColumn<?,?>,TreeTableCell<?,?>>`	`DEFAULT_CELL_FACTORY`	Если для экземпляра TreeTableColumn не указана cellFactory, то по умолчанию будет использоваться эта.

Поля, объявленные в классе javafx.scene.control.TableColumnBase

DEFAULT_COMPARATOR

Резюме конструкторов

Конструктор	Описание
`TreeTableColumn()`	Создаёт TreeTableColumn по умолчанию с фабрикой ячеек, компаратором и реализацией onEditCommit по умолчанию.
`TreeTableColumn(String text)`	Создаёт TreeTableColumn с текстом, установленным на предоставленную строку, с фабрикой ячеек, компаратором и реализацией onEditCommit по умолчанию.

Краткое описание методов

Модификатор и тип	Метод	Описание
`final ObjectProperty<Callback<TreeTableColumn<S,T>,TreeTableCell<S,T>>>`	`cellFactoryProperty()`	Фабрика ячеек для всех ячеек в этом столбце.
`final ObjectProperty<Callback<TreeTableColumn.CellDataFeatures<S,T>,ObservableValue<T>>>`	`cellValueFactoryProperty()`	Необходимо установить фабрику значений ячеек, чтобы указать, как заполнять все ячейки в одном TreeTableColumn.
`static <S, T> EventType<TreeTableColumn.CellEditEvent<S,T>>`	`editAnyEvent()`	Родительское событие для любого события редактирования TreeTableColumn.
`static <S, T> EventType<TreeTableColumn.CellEditEvent<S,T>>`	`editCancelEvent()`	Указывает, что редактирование было отменено, что означает, что изменения не должны быть внесены в исходный источник данных.
`static <S, T> EventType<TreeTableColumn.CellEditEvent<S,T>>`	`editCommitEvent()`	Указывает, что редактирование было подтверждено пользователем, что означает, что изменения должны быть внесены в исходный источник данных, чтобы отразить новые данные.
`static <S, T> EventType<TreeTableColumn.CellEditEvent<S,T>>`	`editStartEvent()`	Указывает, что пользователь выполнил какое-либо взаимодействие для запуска события редактирования, или же был вызван метод `TreeTableView.edit(int, javafx.scene.control.TreeTableColumn)`.
`final Callback<TreeTableColumn<S,T>,TreeTableCell<S,T>>`	`getCellFactory()`	Получает значение свойства `cellFactory`.
`final ObservableValue<T>`	`getCellObservableValue(int index)`	Попытка вернуть ObservableValue<T> для элемента в заданном индексе (который имеет тип S).
`final ObservableValue<T>`	`getCellObservableValue(TreeItem<S> item)`	Попытка вернуть ObservableValue<T> для заданного элемента (который имеет тип S).
`final Callback<TreeTableColumn.CellDataFeatures<S,T>,ObservableValue<T>>`	`getCellValueFactory()`	Получает значение свойства `cellValueFactory`.
`static List<CssMetaData<? extends Styleable,?>>`	`getClassCssMetaData()`	Получает `CssMetaData`, связанный с этим классом, который может включать `CssMetaData` его суперклассов.
`final ObservableList<TreeTableColumn<S,?>>`	`getColumns()`	Это обеспечивает поддержку вложенных столбцов, что может быть полезно для группировки связанных данных.
`List<CssMetaData<? extends Styleable,?>>`	`getCssMetaData()`	CssMetaData этого Styleable.
`final EventHandler<TreeTableColumn.CellEditEvent<S,T>>`	`getOnEditCancel()`	Получает значение свойства `onEditCancel`.
`final EventHandler<TreeTableColumn.CellEditEvent<S,T>>`	`getOnEditCommit()`	Получает значение свойства `onEditCommit`.
`final EventHandler<TreeTableColumn.CellEditEvent<S,T>>`	`getOnEditStart()`	Получает значение свойства `onEditStart`.
`final TreeTableColumn.SortType`	`getSortType()`	Получает значение свойства `sortType`.
`Styleable`	`getStyleableParent()`	Возвращает родителя этого Styleable или null, если родителя нет.
`final TreeTableView<S>`	`getTreeTableView()`	Получает значение свойства `treeTableView`.
`String`	`getTypeSelector()`	Тип этого `Styleable`, который используется для сопоставления селекторов.
`final ObjectProperty<EventHandler<TreeTableColumn.CellEditEvent<S,T>>>`	`onEditCancelProperty()`	Этот обработчик событий будет вызван, когда пользователь отменяет редактирование ячейки.
`final ObjectProperty<EventHandler<TreeTableColumn.CellEditEvent<S,T>>>`	`onEditCommitProperty()`	Этот обработчик событий будет вызван, когда пользователь успешно подтвердит редактирование.
`final ObjectProperty<EventHandler<TreeTableColumn.CellEditEvent<S,T>>>`	`onEditStartProperty()`	Этот обработчик событий будет вызван, когда пользователь успешно инициирует редактирование.
`final void`	`setCellFactory(Callback<TreeTableColumn<S,T>,TreeTableCell<S,T>> value)`	Устанавливает значение свойства `cellFactory`.
`final void`	`setCellValueFactory(Callback<TreeTableColumn.CellDataFeatures<S,T>,ObservableValue<T>> value)`	Устанавливает значение свойства `cellValueFactory`.
`final void`	`setOnEditCancel(EventHandler<TreeTableColumn.CellEditEvent<S,T>> value)`	Устанавливает значение свойства `onEditCancel`.
`final void`	`setOnEditCommit(EventHandler<TreeTableColumn.CellEditEvent<S,T>> value)`	Устанавливает значение свойства `onEditCommit`.
`final void`	`setOnEditStart(EventHandler<TreeTableColumn.CellEditEvent<S,T>> value)`	Устанавливает значение свойства `onEditStart`.
`final void`	`setSortType(TreeTableColumn.SortType value)`	Устанавливает значение свойства `sortType`.
`final ObjectProperty<TreeTableColumn.SortType>`	`sortTypeProperty()`	Используется для указания, должен ли этот столбец, если он является частью порядка сортировки (см. `TreeTableView.getSortOrder()` для получения дополнительной информации), сортироваться по возрастанию или убыванию.
`final ReadOnlyObjectProperty<TreeTableView<S>>`	`treeTableViewProperty()`	TreeTableView, к которому принадлежит этот TreeTableColumn.

Методы, объявленные в классе javafx.scene.control.TableColumnBase

buildEventDispatchChain, comparatorProperty, contextMenuProperty, editableProperty, getCellData, getCellData, getComparator, getContextMenu, getGraphic, getId, getMaxWidth, getMinWidth, getParentColumn, getPrefWidth, getProperties, getPseudoClassStates, getSortNode, getStyle, getStyleClass, getText, getUserData, getWidth, graphicProperty, hasProperties, idProperty, isEditable, isReorderable, isResizable, isSortable, isVisible, maxWidthProperty, minWidthProperty, parentColumnProperty, prefWidthProperty, reorderableProperty, resizableProperty, setComparator, setContextMenu, setEditable, setGraphic, setId, setMaxWidth, setMinWidth, setPrefWidth, setReorderable, setResizable, setSortable, setSortNode, setStyle, setText, setUserData, setVisible, sortableProperty, sortNodeProperty, styleProperty, textProperty, visibleProperty, widthProperty

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы, объявленные в интерфейсе javafx.event.EventTarget

addEventFilter, addEventHandler, buildEventDispatchChain, removeEventFilter, removeEventHandler

Методы, объявленные в интерфейсе javafx.css.Styleable

getStyleableNode

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

treeTableView

public final ReadOnlyObjectProperty<TreeTableView<S>> treeTableViewProperty

Деревовидная таблица, к которой принадлежит этот столбец.

См. также:

getTreeTableView()
treeTableViewProperty()

cellValueFactory

public final ObjectProperty<Callback<TreeTableColumn.CellDataFeatures<S,T>,ObservableValue<T>>> cellValueFactoryProperty

Фабрика значений ячеек необходима для указания способа заполнения всех ячеек в одном столбце TreeTableColumn. Фабрика значений ячеек — это Callback, предоставляющая экземпляр TreeTableColumn.CellDataFeatures и ожидающая возвращения ObservableValue. Возвращаемый экземпляр ObservableValue будет наблюдаться внутри, чтобы изменения значения сразу же отражались на экране.

Пример установки фабрики значений ячеек:


 firstNameCol.setCellValueFactory(new Callback<CellDataFeatures<Person, String>, ObservableValue<String>>() {
     public ObservableValue<String> call(CellDataFeatures<Person, String> p) {
         // p.getValue() returns the TreeItem<Person> instance for a particular TreeTableView row,
         // p.getValue().getValue() returns the Person instance inside the TreeItem<Person>
         return p.getValue().getValue().firstNameProperty();
     }
  });
 }

Общим подходом является заполнение ячеек в TreeTableColumn одним значением из Java-бин. Для поддержки этого распространённого сценария существует класс TreeItemPropertyValueFactory. Обратитесь к этому классу за дополнительной информацией о его использовании, но кратко вот как можно упростить вышеописанный случай с использованием класса TreeItemPropertyValueFactory:


 firstNameCol.setCellValueFactory(new TreeItemPropertyValueFactory<Person,String>("firstName"));

См. также:

getCellValueFactory()
setCellValueFactory(Callback)
cellValueFactoryProperty()

cellFactory

public final ObjectProperty<Callback<TreeTableColumn<S,T>,TreeTableCell<S,T>>> cellFactoryProperty

Фабрика ячеек для всех ячеек в этом столбце. Фабрика ячеек отвечает за отрисовку данных, содержащихся в каждой ячейке TreeTableCell для одного столбца TreeTableColumn.

По умолчанию TreeTableColumn использует default cell factory, но это можно заменить на пользовательскую реализацию, например, для отображения данных другим способом или для поддержки редактирования. Есть много документации по созданию пользовательских фабрик ячеек в других местах (см. Cell и TreeTableView, например).

Наконец, в пакете javafx.scene.control.cell доступно несколько предварительно созданных фабрик ячеек.

См. также:

getCellFactory()
setCellFactory(Callback)
cellFactoryProperty()

sortType

public final ObjectProperty<TreeTableColumn.SortType> sortTypeProperty

Указывает, должен ли этот столбец (если он участвует в порядке сортировки — см. TreeTableView.getSortOrder() для получения подробностей) сортироваться по возрастанию или убыванию. Простое изменение этого свойства приведёт к изменению порядка сортировки в TreeTableView, конечно, при условии, что этот столбец изначально присутствует в ObservableList sortOrder.

См. также:

getSortType()
setSortType(TreeTableColumn.SortType)
sortTypeProperty()

onEditStart

public final ObjectProperty<EventHandler<TreeTableColumn.CellEditEvent<S,T>>> onEditStartProperty

Этот обработчик событий будет срабатывать при успешном начале редактирования пользователем.

См. также:

getOnEditStart()
setOnEditStart(EventHandler)
onEditStartProperty()

onEditCommit

public final ObjectProperty<EventHandler<TreeTableColumn.CellEditEvent<S,T>>> onEditCommitProperty

Этот обработчик событий будет срабатывать при успешной фиксации редактирования пользователем.

См. также:

getOnEditCommit()
setOnEditCommit(EventHandler)
onEditCommitProperty()

onEditCancel

public final ObjectProperty<EventHandler<TreeTableColumn.CellEditEvent<S,T>>> onEditCancelProperty

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

См. также:

getOnEditCancel()
setOnEditCancel(EventHandler)
onEditCancelProperty()

Подробное описание полей

DEFAULT_CELL_FACTORY

public static final Callback<TreeTableColumn<?,?>,TreeTableCell<?,?>> DEFAULT_CELL_FACTORY

Если для экземпляра TreeTableColumn не задана cellFactory, по умолчанию используется данная фабрика. В настоящее время она просто отображает свойство item ячейки TableCell в свойстве graphic, если item является Node, или просто вызывает toString(), если оно не null, устанавливая полученную строку в свойство text.

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

TreeTableColumn

public TreeTableColumn()

Создаёт TreeTableColumn по умолчанию с фабрикой ячеек, компаратором и реализацией onEditCommit по умолчанию.

TreeTableColumn

public TreeTableColumn(String text)

Создаёт TreeTableColumn со строкой в качестве текста, с фабрикой ячеек, компаратором и реализацией onEditCommit по умолчанию.

Параметры:: text - Строка, отображаемая, когда TreeTableColumn помещается в TreeTableView.

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

editAnyEvent

public static <S, T> EventType<TreeTableColumn.CellEditEvent<S,T>> editAnyEvent()

Родительское событие для любого события редактирования TreeTableColumn.

Тип параметров:: S - тип обобщенного типа TreeTableView; T - тип содержимого во всех ячейках этого столбца TreeTableColumn
Возвращает:: событие редактирования

editStartEvent

public static <S, T> EventType<TreeTableColumn.CellEditEvent<S,T>> editStartEvent()

Указывает, что пользователь выполнил какое-то действие для начала события редактирования, или же метод TreeTableView.edit(int, javafx.scene.control.TreeTableColumn) был вызван.

Тип параметров:: S - тип обобщенного типа TreeTableView; T - тип содержимого во всех ячейках этого столбца TreeTableColumn
Возвращает:: событие начала редактирования

editCancelEvent

public static <S, T> EventType<TreeTableColumn.CellEditEvent<S,T>> editCancelEvent()

Указывает, что редактирование было отменено, что означает, что изменения в базовом источнике данных не должны быть внесены.

Тип параметров:: S - тип обобщенного типа TreeTableView; T - тип содержимого во всех ячейках этого столбца TreeTableColumn
Возвращает:: событие отмены редактирования

editCommitEvent

public static <S, T> EventType<TreeTableColumn.CellEditEvent<S,T>> editCommitEvent()

Указывает, что редактирование было подтверждено пользователем, что означает, что изменение должно быть внесено в базовый источник данных, чтобы отразить новые данные.

Тип параметров:: S - тип обобщенного типа TreeTableView; T - тип содержимого во всех ячейках этого столбца TreeTableColumn
Возвращает:: событие подтверждения редактирования

treeTableViewProperty

public final ReadOnlyObjectProperty<TreeTableView<S>> treeTableViewProperty()

Деревовидная таблица, к которой принадлежит этот столбец.

Возвращает:

свойство treeTableView

См. также:

getTreeTableView()

getTreeTableView

public final TreeTableView<S> getTreeTableView()

Получает значение свойства treeTableView.

Описание свойства:

Деревовидная таблица, к которой принадлежит этот столбец.

Возвращает:

значение свойства treeTableView

См. также:

treeTableViewProperty()

END_OF_DOCUMENT_MARKER

setCellValueFactory

public final void setCellValueFactory(Callback<TreeTableColumn.CellDataFeatures<S,T>,ObservableValue<T>> value)

Устанавливает значение свойства cellValueFactory.

Описание свойства:

Необходимо установить фабрику значений ячеек для определения способа заполнения всех ячеек в одном столбце TreeTableColumn. Фабрика значений ячеек — это Callback, которая предоставляет экземпляр TreeTableColumn.CellDataFeatures и ожидает возвращения ObservableValue. Возвращаемый экземпляр ObservableValue будет наблюдаться внутри, чтобы обновления значения мгновенно отображались на экране.

Пример установки фабрики значений ячеек:


 firstNameCol.setCellValueFactory(new Callback<CellDataFeatures<Person, String>, ObservableValue<String>>() {
     public ObservableValue<String> call(CellDataFeatures<Person, String> p) {
         // p.getValue() returns the TreeItem<Person> instance for a particular TreeTableView row,
         // p.getValue().getValue() returns the Person instance inside the TreeItem<Person>
         return p.getValue().getValue().firstNameProperty();
     }
  });
 }

Распространённый подход — заполнение ячеек в TreeTableColumn с использованием одного значения из Java-бин. Для поддержки этого распространённого сценария существует класс TreeItemPropertyValueFactory. Обратитесь к этому классу за дополнительной информацией о его использовании, а вот как этот пример можно упростить с помощью класса TreeItemPropertyValueFactory:


 firstNameCol.setCellValueFactory(new TreeItemPropertyValueFactory<Person,String>("firstName"));

Параметры:

value — значение для свойства cellValueFactory

См. также:

getCellValueFactory()
cellValueFactoryProperty()

getCellValueFactory

public final Callback<TreeTableColumn.CellDataFeatures<S,T>,ObservableValue<T>> getCellValueFactory()

Возвращает значение свойства cellValueFactory.

Описание свойства:

Пример установки фабрики значений ячеек:


 firstNameCol.setCellValueFactory(new Callback<CellDataFeatures<Person, String>, ObservableValue<String>>() {
     public ObservableValue<String> call(CellDataFeatures<Person, String> p) {
         // p.getValue() returns the TreeItem<Person> instance for a particular TreeTableView row,
         // p.getValue().getValue() returns the Person instance inside the TreeItem<Person>
         return p.getValue().getValue().firstNameProperty();
     }
  });
 }


 firstNameCol.setCellValueFactory(new TreeItemPropertyValueFactory<Person,String>("firstName"));

Возвращает:

значение свойства cellValueFactory

См. также:

setCellValueFactory(Callback)
cellValueFactoryProperty()

cellValueFactoryProperty

public final ObjectProperty<Callback<TreeTableColumn.CellDataFeatures<S,T>,ObservableValue<T>>> cellValueFactoryProperty()

Фабрика значений ячеек должна быть установлена для определения способа заполнения всех ячеек в одном столбце TreeTableColumn. Фабрика значений ячеек — это Callback, которая предоставляет экземпляр TreeTableColumn.CellDataFeatures и ожидает возвращения ObservableValue. Возвращаемый экземпляр ObservableValue будет наблюдаться внутри, чтобы обновления значения мгновенно отображались на экране.

Пример установки фабрики значений ячеек:


 firstNameCol.setCellValueFactory(new Callback<CellDataFeatures<Person, String>, ObservableValue<String>>() {
     public ObservableValue<String> call(CellDataFeatures<Person, String> p) {
         // p.getValue() returns the TreeItem<Person> instance for a particular TreeTableView row,
         // p.getValue().getValue() returns the Person instance inside the TreeItem<Person>
         return p.getValue().getValue().firstNameProperty();
     }
  });
 }


 firstNameCol.setCellValueFactory(new TreeItemPropertyValueFactory<Person,String>("firstName"));

Возвращает:

свойство cellValueFactory

См. также:

getCellValueFactory()
setCellValueFactory(Callback)

setCellFactory

public final void setCellFactory(Callback<TreeTableColumn<S,T>,TreeTableCell<S,T>> value)

Устанавливает значение свойства cellFactory.

Описание свойства:

Фабрика ячеек для всех ячеек в этом столбце. Фабрика ячеек отвечает за отображение данных в каждой TreeTableCell для одного TreeTableColumn.

По умолчанию TreeTableColumn использует default cell factory, но её можно заменить на пользовательскую реализацию, например, чтобы отображать данные по-другому или поддерживать редактирование. Подробная документация по созданию пользовательских фабрик ячеек доступна в других разделах (см. Cell и TreeTableView, например).

Наконец, в пакете javafx.scene.control.cell доступно несколько готовых фабрик ячеек.

Параметры:

value — значение для свойства cellFactory

См. также:

getCellFactory()
cellFactoryProperty()

getCellFactory

public final Callback<TreeTableColumn<S,T>,TreeTableCell<S,T>> getCellFactory()

Возвращает значение свойства cellFactory.

Описание свойства:

Наконец, в пакете javafx.scene.control.cell доступно несколько готовых фабрик ячеек.

Возвращает:

значение свойства cellFactory

См. также:

setCellFactory(Callback)
cellFactoryProperty()

cellFactoryProperty

public final ObjectProperty<Callback<TreeTableColumn<S,T>,TreeTableCell<S,T>>> cellFactoryProperty()

Наконец, в пакете javafx.scene.control.cell доступно несколько готовых фабрик ячеек.

Возвращает:

свойство cellFactory

См. также:

getCellFactory()
setCellFactory(Callback)

sortTypeProperty

public final ObjectProperty<TreeTableColumn.SortType> sortTypeProperty()

Указывает, следует ли сортировать этот столбец (если он входит в порядок сортировки, см. TreeTableView.getSortOrder() для получения дополнительной информации) в порядке возрастания или убывания. Простое переключение этого свойства приведет к изменению порядка сортировки в TreeTableView, разумеется, при условии, что этот столбец изначально присутствует в ObservableList sortOrder.

Возвращает:

свойство sortType

См. также:

getSortType()
setSortType(TreeTableColumn.SortType)

setSortType

public final void setSortType(TreeTableColumn.SortType value)

Устанавливает значение свойства sortType.

Описание свойства:

Параметры:

value — значение для свойства sortType

См. также:

getSortType()
sortTypeProperty()

getSortType

public final TreeTableColumn.SortType getSortType()

Получает значение свойства sortType.

Описание свойства:

Используется для указания, следует ли сортировать этот столбец в порядке возрастания или убывания, если он является частью порядка сортировки (см. TreeTableView.getSortOrder() для получения более подробной информации). Простое переключение этого свойства приведет к изменению порядка сортировки в TreeTableView, если, конечно, этот столбец изначально присутствует в списке сортировки ObservableList.

Возвращает:

значение свойства sortType

См. также:

setSortType(TreeTableColumn.SortType)
sortTypeProperty()

setOnEditStart

public final void setOnEditStart(EventHandler<TreeTableColumn.CellEditEvent<S,T>> value)

Устанавливает значение свойства onEditStart.

Описание свойства:

Обработчик событий будет вызван, когда пользователь успешно начнёт редактирование.

Параметры:

value - значение для свойства onEditStart

См. также:

getOnEditStart()
onEditStartProperty()

getOnEditStart

public final EventHandler<TreeTableColumn.CellEditEvent<S,T>> getOnEditStart()

Получает значение свойства onEditStart.

Описание свойства:

Обработчик событий будет вызван, когда пользователь успешно начнёт редактирование.

Возвращает:

значение свойства onEditStart

См. также:

setOnEditStart(EventHandler)
onEditStartProperty()

onEditStartProperty

public final ObjectProperty<EventHandler<TreeTableColumn.CellEditEvent<S,T>>> onEditStartProperty()

Обработчик событий будет вызван, когда пользователь успешно начнёт редактирование.

Возвращает:

свойство onEditStart

См. также:

getOnEditStart()
setOnEditStart(EventHandler)

setOnEditCommit

public final void setOnEditCommit(EventHandler<TreeTableColumn.CellEditEvent<S,T>> value)

Устанавливает значение свойства onEditCommit.

Описание свойства:

Обработчик событий будет вызван, когда пользователь успешно завершит редактирование.

Параметры:

value - значение для свойства onEditCommit

См. также:

getOnEditCommit()
onEditCommitProperty()

getOnEditCommit

public final EventHandler<TreeTableColumn.CellEditEvent<S,T>> getOnEditCommit()

Получает значение свойства onEditCommit.

Описание свойства:

Обработчик событий будет вызван, когда пользователь успешно завершит редактирование.

Возвращает:

значение свойства onEditCommit

См. также:

setOnEditCommit(EventHandler)
onEditCommitProperty()

onEditCommitProperty

public final ObjectProperty<EventHandler<TreeTableColumn.CellEditEvent<S,T>>> onEditCommitProperty()

Обработчик событий будет вызван, когда пользователь успешно завершит редактирование.

Возвращает:

свойство onEditCommit

См. также:

getOnEditCommit()
setOnEditCommit(EventHandler)

setOnEditCancel

public final void setOnEditCancel(EventHandler<TreeTableColumn.CellEditEvent<S,T>> value)

Устанавливает значение свойства onEditCancel.

Описание свойства:

Обработчик событий будет вызван, когда пользователь отменяет редактирование ячейки.

Параметры:

value - значение для свойства onEditCancel

См. также:

getOnEditCancel()
onEditCancelProperty()

getOnEditCancel

public final EventHandler<TreeTableColumn.CellEditEvent<S,T>> getOnEditCancel()

Получает значение свойства onEditCancel.

Описание свойства:

Обработчик событий будет вызван, когда пользователь отменяет редактирование ячейки.

Возвращает:

значение свойства onEditCancel

См. также:

setOnEditCancel(EventHandler)
onEditCancelProperty()

onEditCancelProperty

public final ObjectProperty<EventHandler<TreeTableColumn.CellEditEvent<S,T>>> onEditCancelProperty()

Обработчик событий будет вызван, когда пользователь отменяет редактирование ячейки.

Возвращает:

свойство onEditCancel

См. также:

getOnEditCancel()
setOnEditCancel(EventHandler)

getColumns

public final ObservableList<TreeTableColumn<S,?>> getColumns()

Это обеспечивает поддержку вложенных столбцов, что может быть полезно для группировки связанных данных. Например, у нас может быть столбец 'Имя' с двумя вложенными столбцами для 'Имя' и 'Фамилия'.

Это не влияет на таблицу как таковую — все индексы столбцов указывают только на листья, и отсортировать по родительскому столбцу нельзя, только по листовым. Другими словами, это чисто визуальная функция.

Определено в:: getColumns в классе TableColumnBase<TreeItem<S>,T>
Возвращает:: ObservableList, содержащий TableColumnBase (или подклассы), являющиеся дочерними элементами этого TableColumnBase. Если эти дочерние элементы TableColumnBase установлены как видимые, они будут отображаться под этим столбцом таблицы.

getCellObservableValue

public final ObservableValue<T> getCellObservableValue(int index)

Попытка вернуть ObservableValue<T> для элемента в данном индексе (который имеет тип S). Другими словами, этот метод ожидает получения целого значения, большего или равного нулю и меньшего размера базовой модели данных. Если индекс корректен, этот метод вернёт ObservableValue<T> для этого столбца.

Это достигается вызовом cell value factory и возвратом того, что возвращается при передаче CellDataFeatures (см., например, классы CellDataFeatures, относящиеся к TableColumn и TreeTableColumn для получения дополнительной информации).

Определено в:: getCellObservableValue в классе TableColumnBase<TreeItem<S>,T>
Параметры:: index - Индекс элемента (типа S), для которого требуется ObservableValue<T>.
Возвращает:: ObservableValue<T> для этого конкретного столбца таблицы.

getCellObservableValue

public final ObservableValue<T> getCellObservableValue(TreeItem<S> item)

Попытка вернуть ObservableValue<T> для данного элемента (который имеет тип S). Другими словами, этот метод ожидает получения объекта из базовой модели данных для всей 'строки' в таблице, и он должен вернуть ObservableValue<T> для значения в этом конкретном столбце.

Определено в:: getCellObservableValue в классе TableColumnBase<TreeItem<S>,T>
Параметры:: item - Элемент (типа S), для которого требуется ObservableValue<T>.
Возвращает:: ObservableValue<T> для этого конкретного столбца таблицы.

getTypeSelector

public String getTypeSelector()

Тип этого Styleable, который будет использоваться в сопоставлении селектора. Это аналогично "элементу" в HTML. (CSS Type Selector).

Определено в:: getTypeSelector в интерфейсе Styleable
Возвращает:: "TreeTableColumn"

getStyleableParent

public Styleable getStyleableParent()

Возвращает родителя этого Styleable или null, если родителя нет.

Определено в:: getStyleableParent в интерфейсе Styleable
Возвращает:: getTreeTableView()

getCssMetaData

public List<CssMetaData<? extends Styleable,?>> getCssMetaData()

CssMetaData для этого Styleable. Может возвращаться как неизменяемый список.

Определено в:: getCssMetaData в интерфейсе Styleable
Возвращает:: CssMetaData

getClassCssMetaData

public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()

Получает CssMetaData, связанный с этим классом, который может включать CssMetaData его суперклассов. В настоящее время это пустой список.

Возвращает:: пустой список

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.