{@code
* firstNameCol.setCellValueFactory(new Callback, ObservableValue>() {
* public ObservableValue call(CellDataFeatures p) {
* // p.getValue() returns the TreeItem instance for a particular TreeTableView row,
* // p.getValue().getValue() returns the Person instance inside the TreeItem
* return p.getValue().getValue().firstNameProperty();
* }
* });
* }}
*
* This approach assumes that the object returned from p.getValue().getValue()
* has a JavaFX {@link ObservableValue} that can simply be returned. The benefit of this
* is that the TableView will internally create bindings to ensure that,
* should the returned {@link ObservableValue} change, the cell contents will be
* automatically refreshed.
*
* In situations where a TableColumn must interact with classes created before * JavaFX, or that generally do not wish to use JavaFX APIs for properties, it is * possible to wrap the returned value in a {@link ReadOnlyObjectWrapper} instance. For * example: * *
{@code
* firstNameCol.setCellValueFactory(new Callback, ObservableValue>() {
* public ObservableValue call(CellDataFeatures p) {
* // p.getValue() returns the TreeItem instance for a particular TreeTableView row,
* // p.getValue().getValue() returns the Person instance inside the TreeItem
* return new ReadOnlyObjectWrapper(p.getValue().getValue().getFirstName());
* }
* });
* }}
*
* It is hoped that over time there will be convenience cell value factories
* developed and made available to developers. As of the JavaFX 2.0 release,
* there is one such convenience class: {@link javafx.scene.control.cell.TreeItemPropertyValueFactory}.
* This class removes the need to write the code above, instead relying on reflection to
* look up a given property from a String. Refer to the
* TreeItemPropertyValueFactory class documentation for more information
* on how to use this with a TableColumn.
*
* Finally, for more detail on how to use TableColumn, there is further documentation in
* the {@link TableView} class documentation.
*
* @param toString() if it is not null, setting the resulting string
* inside the {@link Cell#textProperty() text} property.
*/
public static final CallbackAn example of how to set a cell value factory is: * *
{@code
* firstNameCol.setCellValueFactory(new Callback, ObservableValue>() {
* public ObservableValue call(CellDataFeatures p) {
* // p.getValue() returns the TreeItem instance for a particular TreeTableView row,
* // p.getValue().getValue() returns the Person instance inside the TreeItem
* return p.getValue().getValue().firstNameProperty();
* }
* });
* }}
*
* A common approach is to want to populate cells in a TreeTableColumn using
* a single value from a Java bean. To support this common scenario, there
* is the {@link javafx.scene.control.cell.TreeItemPropertyValueFactory} 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 TreeItemPropertyValueFactory class:
*
*
* firstNameCol.setCellValueFactory(new TreeItemPropertyValueFactory<Person,String>("firstName"));
* By default TreeTableColumn uses a {@link #DEFAULT_CELL_FACTORY 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 {@link Cell} and {@link TreeTableView} for example).
* *Finally, there are a number of pre-built cell factories available in the
* {@link javafx.scene.control.cell} package.
*
*/
private final ObjectProperty table = getTreeTableView();
if (table == null) return;
Map table = getTreeTableView();
if (table == null || index >= table.getExpandedItemCount()) return null;
// Get the rowData
TreeItem item = table.getTreeItem(index);
return getCellObservableValue(item);
}
/** {@inheritDoc} */
@Override public final ObservableValue item) {
// Get the factory
final Callback table = getTreeTableView();
if (table == null) return null;
// Call the factory
final TreeTableColumn.CellDataFeatures The TableView type
* @param treeTableView;
private final TreeTableColumn value;
/**
* Instantiates a CellDataFeatures instance with the given properties
* set as read-only values of this instance.
*
* @param treeTableView The TableView that this instance refers to.
* @param tableColumn The TreeTableColumn that this instance refers to.
* @param value The value for a row in the TableView.
*/
public CellDataFeatures(TreeTableView treeTableView,
TreeTableColumn value) {
this.treeTableView = treeTableView;
this.tableColumn = tableColumn;
this.value = value;
}
/**
* Returns the value passed in to the constructor.
* @return the value passed in to the constructor
*/
public TreeItem getValue() {
return value;
}
/**
* Returns the {@link TreeTableColumn} passed in to the constructor.
* @return the {@link TreeTableColumn} passed in to the constructor
*/
public TreeTableColumn getTreeTableView() {
return treeTableView;
}
}
/**
* An event that is fired when a user performs an edit on a table cell.
* @since JavaFX 8.0
*/
public static class CellEditEvent table, TreeTablePosition getTreeTableView() {
return pos.getTreeTableView();
}
/**
* Returns the TreeTableColumn upon which this event occurred.
*
* @return The TreeTableColumn that the edit occurred in.
*/
public TreeTableColumn rowData = getRowValue();
if (rowData == null || pos.getTableColumn() == null) {
return null;
}
// if we are here, we now need to get the data for the specific column
return (T) pos.getTableColumn().getCellData(rowData);
}
/**
* Convenience method that returns the value for the row (that is, from
* the TableView {@link TableView#itemsProperty() items} list), for the
* row contained within the {@link TablePosition} returned in
* {@link #getTreeTablePosition()}.
* @return the row value
*/
public TreeItem getRowValue() {
// List items = getTreeTableView().getItems();
// if (items == null) return null;
TreeTableView treeTable = getTreeTableView();
int row = pos.getRow();
if (row < 0 || row >= treeTable.getExpandedItemCount()) return null;
return treeTable.getTreeItem(row);
}
}
/**
* Enumeration that specifies the type of sorting being applied to a specific
* column.
* @since JavaFX 8.0
*/
public static enum SortType {
/**
* Column will be sorted in an ascending order.
*/
ASCENDING,
/**
* Column will be sorted in a descending order.
*/
DESCENDING;
// UNSORTED
}
}