Class TableColumn<S,​T>

tableView

public final ReadOnlyObjectProperty<TableView<S>> tableViewProperty

See Also:

getTableView()

cellValueFactory

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

 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();
     }
  });
 }
 

 lastNameCol.setCellValueFactory(new PropertyValueFactory<Person,String>("lastName"));
 

See Also:

getCellValueFactory(), setCellValueFactory(Callback)

cellFactory

public final ObjectProperty<Callback<TableColumn<S,T>,​TableCell<S,​T>>> cellFactoryProperty

See Also:

getCellFactory(), setCellFactory(Callback)

sortType

public final ObjectProperty<TableColumn.SortType> sortTypeProperty

See Also:

getSortType(), setSortType(TableColumn.SortType)

onEditStart

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

See Also:

getOnEditStart(), setOnEditStart(EventHandler)

onEditCommit

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

See Also:

getOnEditCommit(), setOnEditCommit(EventHandler)

onEditCancel

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

See Also:

getOnEditCancel(), setOnEditCancel(EventHandler)

DEFAULT_CELL_FACTORY

public static final Callback<TableColumn<?,?>,​TableCell<?,​?>> DEFAULT_CELL_FACTORY

TableColumn

public TableColumn()

TableColumn

public TableColumn(String text)

Parameters:

text - The string to show when the TableColumn is placed within the TableView.

editAnyEvent

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

Type Parameters:

S - The type of the TableView generic type

T - The type of the content in all cells in this TableColumn

Returns:

The any TableColumn edit event

editStartEvent

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

Type Parameters:

S - The type of the TableView generic type

T - The type of the content in all cells in this TableColumn

Returns:

The start an edit event

editCancelEvent

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

Type Parameters:

S - The type of the TableView generic type

T - The type of the content in all cells in this TableColumn

Returns:

The cancel an edit event

editCommitEvent

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

Type Parameters:

S - The type of the TableView generic type

T - The type of the content in all cells in this TableColumn

Returns:

The commit an edit event

tableViewProperty

public final ReadOnlyObjectProperty<TableView<S>> tableViewProperty()

See Also:

getTableView()

getTableView

public final TableView<S> getTableView()

Property description:

The TableView that this TableColumn belongs to.

setCellValueFactory

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

Property description:

The cell value factory needs to be set to specify how to populate all cells within a single TableColumn. A cell value factory is a Callback that provides a TableColumn.CellDataFeatures instance, and expects an ObservableValue to be returned. The returned ObservableValue instance will be observed internally to allow for immediate updates to the value to be reflected on screen. An example of how to set a cell value factory is:

 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();
     }
  });
 }
 

A common approach is to want to populate cells in a TableColumn using a single value from a Java bean. To support this common scenario, there is the PropertyValueFactory class. Refer to this class for more information on how to use it, but briefly here is how the above use case could be simplified using the PropertyValueFactory class:

 lastNameCol.setCellValueFactory(new PropertyValueFactory<Person,String>("lastName"));
 

getCellValueFactory

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

Property description:

The cell value factory needs to be set to specify how to populate all cells within a single TableColumn. A cell value factory is a Callback that provides a TableColumn.CellDataFeatures instance, and expects an ObservableValue to be returned. The returned ObservableValue instance will be observed internally to allow for immediate updates to the value to be reflected on screen. An example of how to set a cell value factory is:

 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();
     }
  });
 }
 

A common approach is to want to populate cells in a TableColumn using a single value from a Java bean. To support this common scenario, there is the PropertyValueFactory class. Refer to this class for more information on how to use it, but briefly here is how the above use case could be simplified using the PropertyValueFactory class:

 lastNameCol.setCellValueFactory(new PropertyValueFactory<Person,String>("lastName"));
 

cellValueFactoryProperty

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

 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();
     }
  });
 }
 

 lastNameCol.setCellValueFactory(new PropertyValueFactory<Person,String>("lastName"));
 

See Also:

getCellValueFactory(), setCellValueFactory(Callback)

setCellFactory

public final void setCellFactory(Callback<TableColumn<S,​T>,​TableCell<S,​T>> value)

Property description:

The cell factory for all cells in this column. The cell factory is responsible for rendering the data contained within each TableCell for a single table column.

By default, TableColumn uses the default cell factory, but this can be replaced with a custom implementation, for example, to show data in a different way or to support editing. There is a lot of documentation on creating custom cell factories elsewhere (see Cell and TableView for example).

Finally, there are a number of pre-built cell factories available in the javafx.scene.control.cell package.

getCellFactory

public final Callback<TableColumn<S,T>,​TableCell<S,​T>> getCellFactory()

Property description:

The cell factory for all cells in this column. The cell factory is responsible for rendering the data contained within each TableCell for a single table column.

By default, TableColumn uses the default cell factory, but this can be replaced with a custom implementation, for example, to show data in a different way or to support editing. There is a lot of documentation on creating custom cell factories elsewhere (see Cell and TableView for example).

Finally, there are a number of pre-built cell factories available in the javafx.scene.control.cell package.

cellFactoryProperty

public final ObjectProperty<Callback<TableColumn<S,T>,​TableCell<S,​T>>> cellFactoryProperty()

See Also:

getCellFactory(), setCellFactory(Callback)

sortTypeProperty

public final ObjectProperty<TableColumn.SortType> sortTypeProperty()

See Also:

getSortType(), setSortType(TableColumn.SortType)

setSortType

public final void setSortType(TableColumn.SortType value)

Property description:

Used to state whether this column, if it is part of a sort order (see TableView.getSortOrder() for more details), should be sorted in ascending or descending order. Simply toggling this property will result in the sort order changing in the TableView, assuming of course that this column is in the sortOrder ObservableList to begin with.

getSortType

public final TableColumn.SortType getSortType()

Property description:

Used to state whether this column, if it is part of a sort order (see TableView.getSortOrder() for more details), should be sorted in ascending or descending order. Simply toggling this property will result in the sort order changing in the TableView, assuming of course that this column is in the sortOrder ObservableList to begin with.

setOnEditStart

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

Property description:

This event handler will be fired when the user successfully initiates editing.

getOnEditStart

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

Property description:

This event handler will be fired when the user successfully initiates editing.

onEditStartProperty

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

See Also:

getOnEditStart(), setOnEditStart(EventHandler)

setOnEditCommit

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

Property description:

This event handler will be fired when the user successfully commits their editing.

getOnEditCommit

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

Property description:

This event handler will be fired when the user successfully commits their editing.

onEditCommitProperty

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

See Also:

getOnEditCommit(), setOnEditCommit(EventHandler)

setOnEditCancel

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

Property description:

This event handler will be fired when the user cancels editing a cell.

getOnEditCancel

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

Property description:

This event handler will be fired when the user cancels editing a cell.

onEditCancelProperty

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

See Also:

getOnEditCancel(), setOnEditCancel(EventHandler)

getTypeSelector

public String getTypeSelector()

Specified by:

getTypeSelector in interface Styleable

Returns:

"TableColumn"

Since:

JavaFX 8.0

getStyleableParent

public Styleable getStyleableParent()

Specified by:

getStyleableParent in interface Styleable

Returns:

getTableView()

Since:

JavaFX 8.0

getCssMetaData

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

Specified by:

getCssMetaData in interface Styleable

Returns:

the CssMetaData

Since:

JavaFX 8.0

getClassCssMetaData

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

Returns:

The CssMetaData associated with this class, which may include the CssMetaData of its superclasses.

Since:

JavaFX 8.0