Spec-Zone.ru › OpenJavaFX 21

Класс TableColumn<S,T>

java.lang.Object
javafx.scene.control.TableColumnBase<S,T>
javafx.scene.control.TableColumn<S,T>
Type Parameters:
S - Тип универсального типа TableView (т.е. S == TableView<S>)
T - Тип содержимого во всех ячейках в этом TableColumn.
Все реализованные интерфейсы:
Styleable, EventTarget
public class TableColumn<S,T> extends TableColumnBase<S,T> implements EventTarget
Таблица TableView состоит из нескольких экземпляров TableColumn. Каждый TableColumn в таблице отвечает за отображение (и редактирование) содержимого этого столбца. Помимо ответственности за отображение и редактирование данных для одного столбца, TableColumn также содержит необходимые свойства для:
  • Изменения размера (с помощью свойств minWidth/prefWidth/maxWidth и width)
  • Включения/выключения видимости с помощью свойства visibility
  • Отображение header text
  • Отображение любых nested columns элементов, которые он может содержать
  • Наличие контекстного меню (context menu) при щелчке правой кнопкой мыши на заголовке столбца
  • Сортировка содержимого таблицы (с помощью comparator, sortable и sortType)
При создании экземпляра TableColumn, возможно, наиболее важными свойствами являются текст столбца text (что отображается в области заголовка столбца) и свойство cell value factory (которое используется для заполнения отдельных ячеек столбца). Это можно сделать с помощью некоторых вариаций следующего кода:
 
 ObservableList<Person> data = ...
 TableView<Person> tableView = new TableView<Person>(data);

 TableColumn<Person,String> firstNameCol = new TableColumn<Person,String>("First Name");
 firstNameCol.setCellValueFactory(new Callback<CellDataFeatures<Person, String>, ObservableValue<String>>() {
     public ObservableValue<String> call(CellDataFeatures<Person, String> p) {
         // p.getValue() returns the Person instance for a particular TableView row
         return p.getValue().firstNameProperty();
     }
  });
 
 tableView.getColumns().add(firstNameCol);}
Этот подход предполагает, что объект, возвращаемый из p.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) {
         return new ReadOnlyObjectWrapper(p.getValue().getFirstName());
     }
  });
Надеемся, что со временем будут разработаны и предоставлены разработчикам удобные фабрики для создания значений ячеек. По состоянию на выпуск JavaFX 2.0 существует один такой удобный класс: PropertyValueFactory. Этот класс устраняет необходимость написания приведенного выше кода, вместо этого используя рефлексию для поиска заданного свойства из строки. См. документацию по классу PropertyValueFactory для получения дополнительной информации о том, как использовать его с TableColumn. Наконец, для более подробного ознакомления с использованием TableColumn см. дополнительную документацию в документации класса TableView.
С момента:
JavaFX 2.0
См. также:
  • TableView
  • TableCell
  • TablePosition

Сводка свойств

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

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

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

Сводка вложенных классов

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

Сводка полей

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

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

DEFAULT_COMPARATOR

Сводка конструкторов

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

Сводка методов

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

Методы, объявленные в классе 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

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

tableView

public final ReadOnlyObjectProperty<TableView<S>> tableViewProperty
Таблица, к которой принадлежит этот столбец.
См. также:
  • getTableView()
  • tableViewProperty()

cellValueFactory

public final ObjectProperty<Callback<TableColumn.CellDataFeatures<S,T>,ObservableValue<T>>> cellValueFactoryProperty
Необходимо установить фабрику значений ячейки, чтобы указать, как заполнять все ячейки в одном столбце. Фабрика значений ячейки — это Callback, предоставляющая экземпляр TableColumn.CellDataFeatures и ожидающая возврата ObservableValue. Возвращаемый экземпляр ObservableValue будет наблюдаться внутри, чтобы позволить мгновенные обновления значения, которые будут отображаться на экране. Пример того, как установить фабрику значений ячейки:

 lastNameCol.setCellValueFactory(new Callback<CellDataFeatures<Person, String>, ObservableValue<String>>() {
     public ObservableValue<String> call(CellDataFeatures<Person, String> p) {
         // p.getValue() returns the Person instance for a particular TableView row
         return p.getValue().lastNameProperty();
     }
  });
 }
 
Общий подход — заполнять ячейки в TableColumn одним значением из объекта Java-биндинга. Для поддержки этого распространённого сценария существует класс PropertyValueFactory. Обратитесь к этому классу за дополнительной информацией о его использовании, но кратко вот как можно упростить вышеуказанный случай с использованием класса PropertyValueFactory:

 lastNameCol.setCellValueFactory(new PropertyValueFactory<Person,String>("lastName"));
 
См. также:
  • getCellValueFactory()
  • setCellValueFactory(Callback)
  • cellValueFactoryProperty()

cellFactory

public final ObjectProperty<Callback<TableColumn<S,T>,TableCell<S,T>>> cellFactoryProperty
Фабрика ячеек для всех ячеек в этом столбце. Фабрика ячеек отвечает за отрисовку данных, содержащихся в каждой TableCell для одного столбца таблицы.

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

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

См. также:
  • getCellFactory()
  • setCellFactory(Callback)
  • cellFactoryProperty()

sortType

public final ObjectProperty<TableColumn.SortType> sortTypeProperty
Используется для указания, должен ли этот столбец, если он является частью порядка сортировки (см. TableView.getSortOrder() для получения дополнительной информации), сортироваться в порядке возрастания или убывания. Простое изменение этого свойства приведет к изменению порядка сортировки в TableView, при условии, что этот столбец изначально присутствует в ObservableList sortOrder.
См. также:
  • getSortType()
  • setSortType(TableColumn.SortType)
  • sortTypeProperty()

onEditStart

public final ObjectProperty<EventHandler<TableColumn.CellEditEvent<S,T>>> onEditStartProperty
Этот обработчик событий будет вызван, когда пользователь успешно начнёт редактирование.
См. также:
  • getOnEditStart()
  • setOnEditStart(EventHandler)
  • onEditStartProperty()

onEditCommit

public final ObjectProperty<EventHandler<TableColumn.CellEditEvent<S,T>>> onEditCommitProperty
Этот обработчик событий будет вызван, когда пользователь успешно завершит редактирование.
См. также:
  • getOnEditCommit()
  • setOnEditCommit(EventHandler)
  • onEditCommitProperty()

onEditCancel

public final ObjectProperty<EventHandler<TableColumn.CellEditEvent<S,T>>> onEditCancelProperty
Этот обработчик событий будет вызван, когда пользователь отменит редактирование ячейки.
См. также:
  • getOnEditCancel()
  • setOnEditCancel(EventHandler)
  • onEditCancelProperty()

Подробности поля

DEFAULT_CELL_FACTORY

public static final Callback<TableColumn<?,?>,TableCell<?,?>> DEFAULT_CELL_FACTORY
Если для экземпляра TableColumn не задана cellFactory, то по умолчанию будет использоваться эта. В настоящее время она просто отображает свойство item класса TableCell в свойстве graphic, если item является узлом, или просто вызывает toString(), если оно не равно null, устанавливая полученную строку в свойство text.

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

TableColumn

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

TableColumn

public TableColumn(String text)
Создаёт столбец таблицы TableColumn со строкой, заданной в качестве текста, с фабрикой ячеек по умолчанию, компаратором и реализацией onEditCommit.
Параметры:
text - Строка, которая будет отображаться, когда TableColumn будет размещён в TableView.

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

editAnyEvent

public static <S, T> EventType<TableColumn.CellEditEvent<S,T>> editAnyEvent()
Родительское событие для любого события редактирования TableColumn.
Тип параметров:
S - Тип обобщённого типа TableView
T - Тип содержимого во всех ячейках в этом TableColumn
Возвращает:
Любое событие редактирования TableColumn

editStartEvent

public static <S, T> EventType<TableColumn.CellEditEvent<S,T>> editStartEvent()
Указывает, что пользователь выполнил некоторое взаимодействие для запуска события редактирования, или альтернативно, был вызван метод TableView.edit(int, javafx.scene.control.TableColumn).
Тип параметров:
S - Тип обобщённого типа TableView
T - Тип содержимого во всех ячейках в этом TableColumn
Возвращает:
Событие начала редактирования

editCancelEvent

public static <S, T> EventType<TableColumn.CellEditEvent<S,T>> editCancelEvent()
Указывает, что редактирование было отменено, что означает, что никакие изменения не должны быть внесены в исходный источник данных.
Тип параметров:
S - Тип обобщённого типа TableView
T - Тип содержимого во всех ячейках в этом TableColumn
Возвращает:
Событие отмены редактирования

editCommitEvent

public static <S, T> EventType<TableColumn.CellEditEvent<S,T>> editCommitEvent()
Указывает, что редактирование было подтверждено пользователем, что означает, что необходимо внести изменения в исходный источник данных, чтобы отразить новые данные.
Тип параметров:
S - Тип обобщённого типа TableView
T - Тип содержимого во всех ячейках в этом TableColumn
Возвращает:
Событие подтверждения редактирования

tableViewProperty

public final ReadOnlyObjectProperty<TableView<S>> tableViewProperty()
Таблица, к которой принадлежит этот столбец.
Возвращает:
свойство tableView
См. также:
  • getTableView()

getTableView

public final TableView<S> getTableView()
Получает значение свойства tableView.
Описание свойства:
Таблица, к которой принадлежит этот столбец.
Возвращает:
значение свойства tableView
См. также:
  • tableViewProperty()

setCellValueFactory

public final void setCellValueFactory(Callback<TableColumn.CellDataFeatures<S,T>,ObservableValue<T>> value)
Устанавливает значение свойства cellValueFactory.
Описание свойства:
Необходимо установить фабрику значений ячейки, чтобы указать, как заполнить все ячейки в одном столбце таблицы. Фабрика значений ячейки — это Callback, которая предоставляет экземпляр TableColumn.CellDataFeatures и ожидает возвращения ObservableValue. Возвращаемый экземпляр ObservableValue будет наблюдаться внутри, чтобы позволить немедленные обновления значения, которые будут отражены на экране. Пример того, как установить фабрику значений ячейки:

 lastNameCol.setCellValueFactory(new Callback<CellDataFeatures<Person, String>, ObservableValue<String>>() {
     public ObservableValue<String> call(CellDataFeatures<Person, String> p) {
         // p.getValue() returns the Person instance for a particular TableView row
         return p.getValue().lastNameProperty();
     }
  });
 }
 
Распространённый подход — заполнение ячеек в TableColumn одним значением из Java-объекта. Для поддержки этой распространённой ситуации существует класс PropertyValueFactory. Обратитесь к этому классу за дополнительной информацией о его использовании, но кратко вот как можно упростить вышеуказанный случай с помощью класса PropertyValueFactory:

 lastNameCol.setCellValueFactory(new PropertyValueFactory<Person,String>("lastName"));
 
Параметры:
value — значение для свойства cellValueFactory
См. также:
  • getCellValueFactory()
  • cellValueFactoryProperty()

getCellValueFactory

public final Callback<TableColumn.CellDataFeatures<S,T>,ObservableValue<T>> getCellValueFactory()
Получает значение свойства cellValueFactory.
Описание свойства:
Необходимо установить фабрику значений ячейки, чтобы указать, как заполнить все ячейки в одном столбце таблицы. Фабрика значений ячейки — это Callback, которая предоставляет экземпляр TableColumn.CellDataFeatures и ожидает возвращения ObservableValue. Возвращаемый экземпляр ObservableValue будет наблюдаться внутри, чтобы позволить немедленные обновления значения, которые будут отражены на экране. Пример того, как установить фабрику значений ячейки:

 lastNameCol.setCellValueFactory(new Callback<CellDataFeatures<Person, String>, ObservableValue<String>>() {
     public ObservableValue<String> call(CellDataFeatures<Person, String> p) {
         // p.getValue() returns the Person instance for a particular TableView row
         return p.getValue().lastNameProperty();
     }
  });
 }
 
Распространённый подход — заполнение ячеек в TableColumn одним значением из Java-объекта. Для поддержки этой распространённой ситуации существует класс PropertyValueFactory. Обратитесь к этому классу за дополнительной информацией о его использовании, но кратко вот как можно упростить вышеуказанный случай с помощью класса PropertyValueFactory:

 lastNameCol.setCellValueFactory(new PropertyValueFactory<Person,String>("lastName"));
 
Возвращает:
значение свойства cellValueFactory
См. также:
  • setCellValueFactory(Callback)
  • cellValueFactoryProperty()

cellValueFactoryProperty

public final ObjectProperty<Callback<TableColumn.CellDataFeatures<S,T>,ObservableValue<T>>> cellValueFactoryProperty()
Фабрика значений ячейки должна быть установлена для указания способа заполнения всех ячеек в одном столбце таблицы. Фабрика значений ячейки представляет собой Callback, которая предоставляет экземпляр TableColumn.CellDataFeatures и ожидает возвращения ObservableValue. Возвращаемый экземпляр ObservableValue будет наблюдаться внутри, чтобы позволить немедленные обновления значения, которые будут отражены на экране. Пример того, как установить фабрику значений ячейки:

 lastNameCol.setCellValueFactory(new Callback<CellDataFeatures<Person, String>, ObservableValue<String>>() {
     public ObservableValue<String> call(CellDataFeatures<Person, String> p) {
         // p.getValue() returns the Person instance for a particular TableView row
         return p.getValue().lastNameProperty();
     }
  });
 }
 
Распространённый подход — заполнение ячеек в TableColumn одним значением из Java-объекта. Для поддержки этой распространённой ситуации существует класс PropertyValueFactory. Обратитесь к этому классу за дополнительной информацией о его использовании, но кратко вот как можно упростить вышеуказанный случай с помощью класса PropertyValueFactory:

 lastNameCol.setCellValueFactory(new PropertyValueFactory<Person,String>("lastName"));
 
Возвращает:
свойство cellValueFactory
См. также:
  • getCellValueFactory()
  • setCellValueFactory(Callback)

setCellFactory

public final void setCellFactory(Callback<TableColumn<S,T>,TableCell<S,T>> value)
Устанавливает значение свойства cellFactory.
Описание свойства:
Фабрика ячеек для всех ячеек в этом столбце. Фабрика ячеек отвечает за отображение данных, содержащихся в каждой TableCell для одного столбца таблицы.

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

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

Параметры:
value — значение для свойства cellFactory
См. также:
  • getCellFactory()
  • cellFactoryProperty()

getCellFactory

public final Callback<TableColumn<S,T>,TableCell<S,T>> getCellFactory()
Получает значение свойства cellFactory.
Описание свойства:
Фабрика ячеек для всех ячеек в этом столбце. Фабрика ячеек отвечает за отображение данных, содержащихся в каждой TableCell для одного столбца таблицы.

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

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

Возвращает:
значение свойства cellFactory
См. также:
  • setCellFactory(Callback)
  • cellFactoryProperty()

cellFactoryProperty

public final ObjectProperty<Callback<TableColumn<S,T>,TableCell<S,T>>> cellFactoryProperty()
Фабрика ячеек для всех ячеек в этом столбце. Фабрика ячеек отвечает за отображение данных, содержащихся в каждой TableCell для одного столбца таблицы.

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

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

Возвращает:
свойство cellFactory
См. также:
  • getCellFactory()
  • setCellFactory(Callback)

sortTypeProperty

public final ObjectProperty<TableColumn.SortType> sortTypeProperty()
Указывает, должен ли этот столбец, если он входит в порядок сортировки (см. TableView.getSortOrder() для более подробной информации), сортироваться по возрастанию или убыванию. Простое переключение этого свойства приведет к изменению порядка сортировки в TableView, при условии, конечно, что этот столбец изначально находится в списке сортировки sortOrder.
Возвращает:
свойство sortType
См. также:
  • getSortType()
  • setSortType(TableColumn.SortType)

setSortType

public final void setSortType(TableColumn.SortType value)
Устанавливает значение свойства sortType.
Описание свойства:
Указывает, должен ли этот столбец, если он входит в порядок сортировки (см. TableView.getSortOrder() для более подробной информации), сортироваться по возрастанию или убыванию. Простое переключение этого свойства приведет к изменению порядка сортировки в TableView, при условии, конечно, что этот столбец изначально находится в списке сортировки sortOrder.
Параметры:
value — значение для свойства sortType
См. также:
  • getSortType()
  • sortTypeProperty()
END_OF_DOCUMENT_MARKER

getSortType

public final TableColumn.SortType getSortType()
Получает значение свойства sortType.
Описание свойства:
Указывает, следует ли сортировать этот столбец по возрастанию или убыванию, если он является частью порядка сортировки (см. TableView.getSortOrder() для получения дополнительных сведений). Простое изменение этого свойства приведет к изменению порядка сортировки в TableView, при условии, что этот столбец изначально присутствует в ObservableList sortOrder.
Возвращает:
значение свойства sortType
См. также:
  • setSortType(TableColumn.SortType)
  • sortTypeProperty()

setOnEditStart

public final void setOnEditStart(EventHandler<TableColumn.CellEditEvent<S,T>> value)
Устанавливает значение свойства onEditStart.
Описание свойства:
Обработчик событий, который будет вызван, когда пользователь успешно начнёт редактирование.
Параметры:
value - значение для свойства onEditStart
См. также:
  • getOnEditStart()
  • onEditStartProperty()

getOnEditStart

public final EventHandler<TableColumn.CellEditEvent<S,T>> getOnEditStart()
Получает значение свойства onEditStart.
Описание свойства:
Обработчик событий, который будет вызван, когда пользователь успешно начнёт редактирование.
Возвращает:
значение свойства onEditStart
См. также:
  • setOnEditStart(EventHandler)
  • onEditStartProperty()

onEditStartProperty

public final ObjectProperty<EventHandler<TableColumn.CellEditEvent<S,T>>> onEditStartProperty()
Обработчик событий, который будет вызван, когда пользователь успешно начнёт редактирование.
Возвращает:
свойство on edit start
См. также:
  • getOnEditStart()
  • setOnEditStart(EventHandler)

setOnEditCommit

public final void setOnEditCommit(EventHandler<TableColumn.CellEditEvent<S,T>> value)
Устанавливает значение свойства onEditCommit.
Описание свойства:
Обработчик событий, который будет вызван, когда пользователь успешно подтвердит редактирование.
Параметры:
value - значение для свойства onEditCommit
См. также:
  • getOnEditCommit()
  • onEditCommitProperty()

getOnEditCommit

public final EventHandler<TableColumn.CellEditEvent<S,T>> getOnEditCommit()
Получает значение свойства onEditCommit.
Описание свойства:
Обработчик событий, который будет вызван, когда пользователь успешно подтвердит редактирование.
Возвращает:
значение свойства onEditCommit
См. также:
  • setOnEditCommit(EventHandler)
  • onEditCommitProperty()

onEditCommitProperty

public final ObjectProperty<EventHandler<TableColumn.CellEditEvent<S,T>>> onEditCommitProperty()
Обработчик событий, который будет вызван, когда пользователь успешно подтвердит редактирование.
Возвращает:
свойство on edit commit
См. также:
  • getOnEditCommit()
  • setOnEditCommit(EventHandler)

setOnEditCancel

public final void setOnEditCancel(EventHandler<TableColumn.CellEditEvent<S,T>> value)
Устанавливает значение свойства onEditCancel.
Описание свойства:
Обработчик событий, который будет вызван, когда пользователь отменяет редактирование ячейки.
Параметры:
value - значение для свойства onEditCancel
См. также:
  • getOnEditCancel()
  • onEditCancelProperty()

getOnEditCancel

public final EventHandler<TableColumn.CellEditEvent<S,T>> getOnEditCancel()
Получает значение свойства onEditCancel.
Описание свойства:
Обработчик событий, который будет вызван, когда пользователь отменяет редактирование ячейки.
Возвращает:
значение свойства onEditCancel
См. также:
  • setOnEditCancel(EventHandler)
  • onEditCancelProperty()

onEditCancelProperty

public final ObjectProperty<EventHandler<TableColumn.CellEditEvent<S,T>>> onEditCancelProperty()
Обработчик событий, который будет вызван, когда пользователь отменяет редактирование ячейки.
Возвращает:
свойство on edit cancel
См. также:
  • getOnEditCancel()
  • setOnEditCancel(EventHandler)

getColumns

public final ObservableList<TableColumn<S,?>> getColumns()
Это обеспечивает поддержку вложенных столбцов, что может быть полезно для группировки связанных данных. Например, у нас может быть столбец «Имя» с двумя вложенными столбцами для «Имени» и «Фамилии».

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

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

getCellObservableValue

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

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

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

getTypeSelector

public String getTypeSelector()
Тип этого Styleable, который будет использоваться для сопоставления в селекторе. Это аналогично «элементу» в HTML. (CSS Type Selector).
Определено в:
getTypeSelector в интерфейсе Styleable
Возвращает:
«TableColumn»
С:
JavaFX 8.0

getStyleableParent

public Styleable getStyleableParent()
Возвращает родительский элемент этого Styleable или null, если родительский элемент отсутствует.
Определено в:
getStyleableParent в интерфейсе Styleable
Возвращает:
getTableView()
С:
JavaFX 8.0

getCssMetaData

public List<CssMetaData<? extends Styleable,?>> getCssMetaData()
CssMetaData этого Styleable. Может быть возвращен как неизменяемый список.
Определено в:
getCssMetaData в интерфейсе Styleable
Возвращает:
CssMetaData
С:
JavaFX 8.0

getClassCssMetaData

public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()
Получает CssMetaData, связанную с этим классом, которая может включать CssMetaData его суперклассов.
Возвращает:
CssMetaData
С:
JavaFX 8.0

© 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API