S
- The type of the objects contained within the TableView items list.@DefaultProperty(value="items") public class TableView<S> extends Control
ListView
control, with the addition of support for columns. For an
example on how to create a TableView, refer to the 'Creating a TableView'
control section below.
The TableView control has a number of features, including:
TableColumn
API:
cell factories
to
easily customize cell
contents in both rendering and editing
states.
minWidth
/
prefWidth
/maxWidth
,
and also fixed width columns
.
column nesting
resizing policies
to
dictate what happens when the user resizes columns.
multiple column sorting
by clicking
the column header (hold down Shift keyboard key whilst clicking on a
header to sort by multiple columns).
Note that TableView is intended to be used for visualize data - it is not
intended to be used for laying out your user interface. If you want to lay
your user interface out in a grid-like fashion, consider the
GridPane
layout.
Creating a TableView is a multi-step process, and also depends on the
underlying data model needing to be represented. For this example we'll use
an ObservableList Firstly, a TableView instance needs to be defined, as such:
With the basic table defined, we next focus on the data model. As mentioned,
for this example, we'll be using a ObservableList With the items set as such, TableView will automatically update whenever
the At this point we now have a TableView hooked up to observe the
With the code shown above we have fully defined the minimum properties
required to create a TableView instance. Running this code (assuming the
people ObservableList is appropriately created) will result in a TableView being
shown with two columns for firstName and lastName. Any other properties of the
Person class will not be shown, as no TableColumns are defined.
The code shown above is the shortest possible code for creating a TableView
when the domain objects are designed with JavaFX properties in mind
(additionally, To track selection and focus, it is necessary to become familiar with the
The default The visuals of the TableView can be entirely customized by replacing the
default In many cases, this is not what is desired however, as it is more commonly
the case that cells be customized on a per-column basis, not a per-row basis.
It is therefore important to note that a You can create custom See the Person
class will consist of a first
name and last name properties. That is:
public class Person {
private StringProperty firstName;
public void setFirstName(String value) { firstNameProperty().set(value); }
public String getFirstName() { return firstNameProperty().get(); }
public StringProperty firstNameProperty() {
if (firstName == null) firstName = new SimpleStringProperty(this, "firstName");
return firstName;
}
private StringProperty lastName;
public void setLastName(String value) { lastNameProperty().set(value); }
public String getLastName() { return lastNameProperty().get(); }
public StringProperty lastNameProperty() {
if (lastName == null) lastName = new SimpleStringProperty(this, "lastName");
return lastName;
}
}
TableView<Person> table = new TableView<Person>();
ObservableList<Person> teamMembers = getTeamMembers();
table.setItems(teamMembers);
teamMembers
list changes. If the items list is available
before the TableView is instantiated, it is possible to pass it directly into
the constructor.
teamMembers
observableList. The missing ingredient
now is the means of splitting out the data contained within the model and
representing it in one or more TableColumn
instances. To
create a two-column TableView to show the firstName and lastName properties,
we extend the last code sample as follows:
ObservableList<Person> teamMembers = ...;
table.setItems(teamMembers);
TableColumn<Person,String> firstNameCol = new TableColumn<Person,String>("First Name");
firstNameCol.setCellValueFactory(new PropertyValueFactory("firstName"));
TableColumn<Person,String> lastNameCol = new TableColumn<Person,String>("Last Name");
lastNameCol.setCellValueFactory(new PropertyValueFactory("lastName"));
table.getColumns().setAll(firstNameCol, lastNameCol);
TableView support for classes that don't contain properties
PropertyValueFactory
supports
normal JavaBean properties too, although there is a caveat to this, so refer
to the class documentation for more information). When this is not the case,
it is necessary to provide a custom cell value factory. More information
about cell value factories can be found in the TableColumn
API
documentation, but briefly, here is how a TableColumn could be specified:
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 Selection / Focus APIs
SelectionModel
and FocusModel
classes. A TableView has at most
one instance of each of these classes, available from
selectionModel
and
focusModel
properties respectively.
Whilst it is possible to use this API to set a new selection model, in
most circumstances this is not necessary - the default selection and focus
models should work in most circumstances.
SelectionModel
used when instantiating a TableView is
an implementation of the MultipleSelectionModel
abstract class.
However, as noted in the API documentation for
the selectionMode
property, the default value is SelectionMode.SINGLE
. To enable
multiple selection in a default TableView instance, it is therefore necessary
to do the following:
tableView.getSelectionModel().setSelectionMode(SelectionMode.MULTIPLE);
Customizing TableView Visuals
row factory
. A row factory is used to
generate TableRow
instances, which are used to represent an entire
row in the TableView.
TableRow
is not a
TableCell
. A TableRow
is simply a container for zero or more
TableCell
, and in most circumstances it is more likely that you'll
want to create custom TableCells, rather than TableRows. The primary use case
for creating custom TableRow instances would most probably be to introduce
some form of column spanning support.
TableCell
instances per column by assigning
the appropriate function to the TableColumn
cell factory
property.
Cell
class documentation for a more complete
description of how to write custom Cells.
TableColumn
,
TablePosition
Type | Property and Description |
---|---|
ObjectProperty<Callback<TableView.ResizeFeatures,java.lang.Boolean>> |
columnResizePolicy
This is the function called when the user completes a column-resize
operation.
|
BooleanProperty |
editable
Specifies whether this TableView is editable - only if the TableView, the
TableColumn (if applicable) and the TableCells within it are both
editable will a TableCell be able to go into their editing state.
|
ReadOnlyObjectProperty<TablePosition<S,?>> |
editingCell
Represents the current cell being edited, or null if
there is no cell being edited.
|
ObjectProperty<TableView.TableViewFocusModel<S>> |
focusModel
Represents the currently-installed
TableView.TableViewFocusModel for this
TableView. |
ObjectProperty<ObservableList<S>> |
items
The underlying data model for the TableView.
|
ObjectProperty<Node> |
placeholder
This Node is shown to the user when the table has no content to show.
|
ObjectProperty<Callback<TableView<S>,TableRow<S>>> |
rowFactory
A function which produces a TableRow.
|
ObjectProperty<TableView.TableViewSelectionModel<S>> |
selectionModel
The SelectionModel provides the API through which it is possible
to select single or multiple items within a TableView, as well as inspect
which items have been selected by the user.
|
BooleanProperty |
tableMenuButtonVisible
This controls whether a menu button is available when the user clicks
in a designated space within the TableView, within which is a radio menu
item for each TableColumn in this table.
|
contextMenu, height, maxHeight, maxWidth, minHeight, minWidth, prefHeight, prefWidth, skinClassName, skin, tooltip, width
needsLayout
blendMode, boundsInLocal, boundsInParent, cacheHint, cache, clip, cursor, depthTest, disabled, disable, effect, eventDispatcher, focused, focusTraversable, hover, id, inputMethodRequests, layoutBounds, layoutX, layoutY, localToParentTransform, localToSceneTransform, managed, mouseTransparent, onContextMenuRequested, onDragDetected, onDragDone, onDragDropped, onDragEntered, onDragExited, onDragOver, onInputMethodTextChanged, onKeyPressed, onKeyReleased, onKeyTyped, onMouseClicked, onMouseDragEntered, onMouseDragExited, onMouseDragged, onMouseDragOver, onMouseDragReleased, onMouseEntered, onMouseExited, onMouseMoved, onMousePressed, onMouseReleased, onRotate, onRotationFinished, onRotationStarted, onScrollFinished, onScroll, onScrollStarted, onSwipeDown, onSwipeLeft, onSwipeRight, onSwipeUp, onTouchMoved, onTouchPressed, onTouchReleased, onTouchStationary, onZoomFinished, onZoom, onZoomStarted, opacity, parent, pickOnBounds, pressed, rotate, rotationAxis, scaleX, scaleY, scaleZ, scene, style, translateX, translateY, translateZ, visible
Modifier and Type | Class and Description |
---|---|
static class |
TableView.ResizeFeatures<S>
An immutable wrapper class for use in the TableView
column resize functionality. |
static class |
TableView.TableViewFocusModel<S>
A
FocusModel with additional functionality to support the requirements
of a TableView control. |
static class |
TableView.TableViewSelectionModel<S>
A simple extension of the
SelectionModel abstract class to
allow for special support for TableView controls. |
Modifier and Type | Field and Description |
---|---|
static Callback<TableView.ResizeFeatures,java.lang.Boolean> |
CONSTRAINED_RESIZE_POLICY
Simple policy that ensures the width of all visible leaf columns in
this table sum up to equal the width of the table itself.
|
static Callback<TableView.ResizeFeatures,java.lang.Boolean> |
UNCONSTRAINED_RESIZE_POLICY
Very simple resize policy that just resizes the specified column by the
provided delta and shifts all other columns (to the right of the given column)
further to the right (when the delta is positive) or to the left (when the
delta is negative).
|
USE_COMPUTED_SIZE, USE_PREF_SIZE
Constructor and Description |
---|
TableView()
Creates a default TableView control with no content.
|
TableView(ObservableList<S> items)
Creates a TableView with the content provided in the items ObservableList.
|
Modifier and Type | Method and Description |
---|---|
ObjectProperty<Callback<TableView.ResizeFeatures,java.lang.Boolean>> |
columnResizePolicyProperty()
This is the function called when the user completes a column-resize
operation.
|
void |
edit(int row,
TableColumn<S,?> column)
Causes the cell at the given row/column view indexes to switch into
its editing state, if it is not already in it, and assuming that the
TableView and column are also editable.
|
BooleanProperty |
editableProperty()
Specifies whether this TableView is editable - only if the TableView, the
TableColumn (if applicable) and the TableCells within it are both
editable will a TableCell be able to go into their editing state.
|
ReadOnlyObjectProperty<TablePosition<S,?>> |
editingCellProperty()
Represents the current cell being edited, or null if
there is no cell being edited.
|
ObjectProperty<TableView.TableViewFocusModel<S>> |
focusModelProperty()
Represents the currently-installed
TableView.TableViewFocusModel for this
TableView. |
Callback<TableView.ResizeFeatures,java.lang.Boolean> |
getColumnResizePolicy()
Gets the value of the property columnResizePolicy.
|
ObservableList<TableColumn<S,?>> |
getColumns()
The TableColumns that are part of this TableView.
|
TablePosition<S,?> |
getEditingCell()
Gets the value of the property editingCell.
|
TableView.TableViewFocusModel<S> |
getFocusModel()
Gets the value of the property focusModel.
|
ObservableList<S> |
getItems()
Gets the value of the property items.
|
Node |
getPlaceholder()
Gets the value of the property placeholder.
|
Callback<TableView<S>,TableRow<S>> |
getRowFactory()
Gets the value of the property rowFactory.
|
TableView.TableViewSelectionModel<S> |
getSelectionModel()
Gets the value of the property selectionModel.
|
ObservableList<TableColumn<S,?>> |
getSortOrder()
The sortOrder list defines the order in which
TableColumn instances
are sorted. |
TableColumn<S,?> |
getVisibleLeafColumn(int column)
Returns the TableColumn in the given column index, relative to all other
visible leaf columns.
|
ObservableList<TableColumn<S,?>> |
getVisibleLeafColumns()
Returns an unmodifiable list containing the currently visible leaf columns.
|
int |
getVisibleLeafIndex(TableColumn<S,?> column)
Returns the position of the given column, relative to all other
visible leaf columns.
|
boolean |
isEditable()
Gets the value of the property editable.
|
boolean |
isTableMenuButtonVisible()
Gets the value of the property tableMenuButtonVisible.
|
ObjectProperty<ObservableList<S>> |
itemsProperty()
The underlying data model for the TableView.
|
ObjectProperty<Node> |
placeholderProperty()
This Node is shown to the user when the table has no content to show.
|
boolean |
resizeColumn(TableColumn<S,?> column,
double delta)
Applies the currently installed resize policy against the given column,
resizing it based on the delta value provided.
|
ObjectProperty<Callback<TableView<S>,TableRow<S>>> |
rowFactoryProperty()
A function which produces a TableRow.
|
void |
scrollTo(int index)
Scrolls the TableView so that the given index is visible within the viewport.
|
ObjectProperty<TableView.TableViewSelectionModel<S>> |
selectionModelProperty()
The SelectionModel provides the API through which it is possible
to select single or multiple items within a TableView, as well as inspect
which items have been selected by the user.
|
void |
setColumnResizePolicy(Callback<TableView.ResizeFeatures,java.lang.Boolean> callback)
Sets the value of the property columnResizePolicy.
|
void |
setEditable(boolean value)
Sets the value of the property editable.
|
void |
setFocusModel(TableView.TableViewFocusModel<S> value)
Sets the value of the property focusModel.
|
void |
setItems(ObservableList<S> value)
Sets the value of the property items.
|
void |
setPlaceholder(Node value)
Sets the value of the property placeholder.
|
void |
setRowFactory(Callback<TableView<S>,TableRow<S>> value)
Sets the value of the property rowFactory.
|
void |
setSelectionModel(TableView.TableViewSelectionModel<S> value)
Sets the value of the property selectionModel.
|
void |
setTableMenuButtonVisible(boolean value)
Sets the value of the property tableMenuButtonVisible.
|
BooleanProperty |
tableMenuButtonVisibleProperty()
This controls whether a menu button is available when the user clicks
in a designated space within the TableView, within which is a radio menu
item for each TableColumn in this table.
|
computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, contextMenuProperty, getBaselineOffset, getContextMenu, getHeight, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getPrefHeight, getPrefWidth, getSkin, getTooltip, getUserAgentStylesheet, getWidth, heightProperty, intersects, isResizable, layoutChildren, maxHeight, maxHeightProperty, maxWidth, maxWidthProperty, minHeight, minHeightProperty, minWidth, minWidthProperty, prefHeight, prefHeightProperty, prefWidth, prefWidthProperty, resize, setContextMenu, setHeight, setMaxHeight, setMaxSize, setMaxWidth, setMinHeight, setMinSize, setMinWidth, setPrefHeight, setPrefSize, setPrefWidth, setSkin, setSkinClassName, setTooltip, setWidth, skinClassNameProperty, skinProperty, tooltipProperty, widthProperty
getChildren, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, lookup, needsLayoutProperty, requestLayout, setNeedsLayout
addEventFilter, addEventHandler, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, contains, contains, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectProperty, eventDispatcherProperty, fireEvent, focusedProperty, focusTraversableProperty, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClip, getContentBias, getCursor, getDepthTest, getEffect, getEventDispatcher, getId, getInputMethodRequests, getLayoutBounds, getLayoutX, getLayoutY, getLocalToParentTransform, getLocalToSceneTransform, getOnContextMenuRequested, getOnDragDetected, getOnDragDone, getOnDragDropped, getOnDragEntered, getOnDragExited, getOnDragOver, getOnInputMethodTextChanged, getOnKeyPressed, getOnKeyReleased, getOnKeyTyped, getOnMouseClicked, getOnMouseDragEntered, getOnMouseDragExited, getOnMouseDragged, getOnMouseDragOver, getOnMouseDragReleased, getOnMouseEntered, getOnMouseExited, getOnMouseMoved, getOnMousePressed, getOnMouseReleased, getOnRotate, getOnRotationFinished, getOnRotationStarted, getOnScroll, getOnScrollFinished, getOnScrollStarted, getOnSwipeDown, getOnSwipeLeft, getOnSwipeRight, getOnSwipeUp, getOnTouchMoved, getOnTouchPressed, getOnTouchReleased, getOnTouchStationary, getOnZoom, getOnZoomFinished, getOnZoomStarted, getOpacity, getParent, getProperties, getRotate, getRotationAxis, getScaleX, getScaleY, getScaleZ, getScene, getStyle, getStyleClass, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getUserData, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, isVisible, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParent, localToParent, localToParent, localToParentTransformProperty, localToScene, localToScene, localToScene, localToSceneTransformProperty, lookupAll, managedProperty, mouseTransparentProperty, onContextMenuRequestedProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDragEnteredProperty, onMouseDragExitedProperty, onMouseDraggedProperty, onMouseDragOverProperty, onMouseDragReleasedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onRotateProperty, onRotationFinishedProperty, onRotationStartedProperty, onScrollFinishedProperty, onScrollProperty, onScrollStartedProperty, onSwipeDownProperty, onSwipeLeftProperty, onSwipeRightProperty, onSwipeUpProperty, onTouchMovedProperty, onTouchPressedProperty, onTouchReleasedProperty, onTouchStationaryProperty, onZoomFinishedProperty, onZoomProperty, onZoomStartedProperty, opacityProperty, parentProperty, parentToLocal, parentToLocal, parentToLocal, pickOnBoundsProperty, pressedProperty, relocate, removeEventFilter, removeEventHandler, requestFocus, resizeRelocate, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, sceneToLocal, sceneToLocal, sceneToLocal, setBlendMode, setCache, setCacheHint, setClip, setCursor, setDepthTest, setDisable, setDisabled, setEffect, setEventDispatcher, setEventHandler, setFocused, setFocusTraversable, setHover, setId, setInputMethodRequests, setLayoutX, setLayoutY, setManaged, setMouseTransparent, setOnContextMenuRequested, setOnDragDetected, setOnDragDone, setOnDragDropped, setOnDragEntered, setOnDragExited, setOnDragOver, setOnInputMethodTextChanged, setOnKeyPressed, setOnKeyReleased, setOnKeyTyped, setOnMouseClicked, setOnMouseDragEntered, setOnMouseDragExited, setOnMouseDragged, setOnMouseDragOver, setOnMouseDragReleased, setOnMouseEntered, setOnMouseExited, setOnMouseMoved, setOnMousePressed, setOnMouseReleased, setOnRotate, setOnRotationFinished, setOnRotationStarted, setOnScroll, setOnScrollFinished, setOnScrollStarted, setOnSwipeDown, setOnSwipeLeft, setOnSwipeRight, setOnSwipeUp, setOnTouchMoved, setOnTouchPressed, setOnTouchReleased, setOnTouchStationary, setOnZoom, setOnZoomFinished, setOnZoomStarted, setOpacity, setPickOnBounds, setPressed, setRotate, setRotationAxis, setScaleX, setScaleY, setScaleZ, setStyle, setTranslateX, setTranslateY, setTranslateZ, setUserData, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, visibleProperty
public final ObjectProperty<ObservableList<S>> itemsProperty
getItems()
,
setItems(ObservableList)
public final BooleanProperty tableMenuButtonVisibleProperty
public final ObjectProperty<Callback<TableView.ResizeFeatures,java.lang.Boolean>> columnResizePolicyProperty
UNCONSTRAINED_RESIZE_POLICY
and
CONSTRAINED_RESIZE_POLICY
.public final ObjectProperty<Callback<TableView<S>,TableRow<S>>> rowFactoryProperty
Note that a TableRow is not a TableCell. A TableRow is simply a container for a TableCell, and in most circumstances it is more likely that you'll want to create custom TableCells, rather than TableRows. The primary use case for creating custom TableRow instances would most probably be to introduce some form of column spanning support.
You can create custom TableCell instances per column by assigning the appropriate function to the cellFactory property in the TableColumn class.
getRowFactory()
,
setRowFactory(Callback)
public final ObjectProperty<Node> placeholderProperty
getPlaceholder()
,
setPlaceholder(Node)
public final ObjectProperty<TableView.TableViewSelectionModel<S>> selectionModelProperty
public final ObjectProperty<TableView.TableViewFocusModel<S>> focusModelProperty
TableView.TableViewFocusModel
for this
TableView. Under almost all circumstances leaving this as the default
focus model will suffice.public final BooleanProperty editableProperty
isEditable()
,
setEditable(boolean)
public final ReadOnlyObjectProperty<TablePosition<S,?>> editingCellProperty
getEditingCell()
public static final Callback<TableView.ResizeFeatures,java.lang.Boolean> UNCONSTRAINED_RESIZE_POLICY
Very simple resize policy that just resizes the specified column by the provided delta and shifts all other columns (to the right of the given column) further to the right (when the delta is positive) or to the left (when the delta is negative).
It also handles the case where we have nested columns by sharing the new space, or subtracting the removed space, evenly between all immediate children columns. Of course, the immediate children may themselves be nested, and they would then use this policy on their children.
public static final Callback<TableView.ResizeFeatures,java.lang.Boolean> CONSTRAINED_RESIZE_POLICY
Simple policy that ensures the width of all visible leaf columns in this table sum up to equal the width of the table itself.
When the user resizes a column width with this policy, the table automatically adjusts the width of the right hand side columns. When the user increases a column width, the table decreases the width of the rightmost column until it reaches its minimum width. Then it decreases the width of the second rightmost column until it reaches minimum width and so on. When all right hand side columns reach minimum size, the user cannot increase the size of resized column any more.
public TableView()
Refer to the TableView
class documentation for details on the
default state of other properties.
public TableView(ObservableList<S> items)
Refer to the TableView
class documentation for details on the
default state of other properties.
items
- The items to insert into the TableView, and the list to watch
for changes (to automatically show in the TableView).public final ObjectProperty<ObservableList<S>> itemsProperty()
getItems()
,
setItems(ObservableList)
public final void setItems(ObservableList<S> value)
public final ObservableList<S> getItems()
public final BooleanProperty tableMenuButtonVisibleProperty()
public final void setTableMenuButtonVisible(boolean value)
public final boolean isTableMenuButtonVisible()
public final void setColumnResizePolicy(Callback<TableView.ResizeFeatures,java.lang.Boolean> callback)
UNCONSTRAINED_RESIZE_POLICY
and
CONSTRAINED_RESIZE_POLICY
.public final Callback<TableView.ResizeFeatures,java.lang.Boolean> getColumnResizePolicy()
UNCONSTRAINED_RESIZE_POLICY
and
CONSTRAINED_RESIZE_POLICY
.public final ObjectProperty<Callback<TableView.ResizeFeatures,java.lang.Boolean>> columnResizePolicyProperty()
UNCONSTRAINED_RESIZE_POLICY
and
CONSTRAINED_RESIZE_POLICY
.public final ObjectProperty<Callback<TableView<S>,TableRow<S>>> rowFactoryProperty()
Note that a TableRow is not a TableCell. A TableRow is simply a container for a TableCell, and in most circumstances it is more likely that you'll want to create custom TableCells, rather than TableRows. The primary use case for creating custom TableRow instances would most probably be to introduce some form of column spanning support.
You can create custom TableCell instances per column by assigning the appropriate function to the cellFactory property in the TableColumn class.
getRowFactory()
,
setRowFactory(Callback)
public final void setRowFactory(Callback<TableView<S>,TableRow<S>> value)
Note that a TableRow is not a TableCell. A TableRow is simply a container for a TableCell, and in most circumstances it is more likely that you'll want to create custom TableCells, rather than TableRows. The primary use case for creating custom TableRow instances would most probably be to introduce some form of column spanning support.
You can create custom TableCell instances per column by assigning the appropriate function to the cellFactory property in the TableColumn class.
public final Callback<TableView<S>,TableRow<S>> getRowFactory()
Note that a TableRow is not a TableCell. A TableRow is simply a container for a TableCell, and in most circumstances it is more likely that you'll want to create custom TableCells, rather than TableRows. The primary use case for creating custom TableRow instances would most probably be to introduce some form of column spanning support.
You can create custom TableCell instances per column by assigning the appropriate function to the cellFactory property in the TableColumn class.
public final ObjectProperty<Node> placeholderProperty()
getPlaceholder()
,
setPlaceholder(Node)
public final void setPlaceholder(Node value)
public final Node getPlaceholder()
public final ObjectProperty<TableView.TableViewSelectionModel<S>> selectionModelProperty()
public final void setSelectionModel(TableView.TableViewSelectionModel<S> value)
public final TableView.TableViewSelectionModel<S> getSelectionModel()
public final void setFocusModel(TableView.TableViewFocusModel<S> value)
TableView.TableViewFocusModel
for this
TableView. Under almost all circumstances leaving this as the default
focus model will suffice.public final TableView.TableViewFocusModel<S> getFocusModel()
TableView.TableViewFocusModel
for this
TableView. Under almost all circumstances leaving this as the default
focus model will suffice.public final ObjectProperty<TableView.TableViewFocusModel<S>> focusModelProperty()
TableView.TableViewFocusModel
for this
TableView. Under almost all circumstances leaving this as the default
focus model will suffice.public final void setEditable(boolean value)
public final boolean isEditable()
public final BooleanProperty editableProperty()
isEditable()
,
setEditable(boolean)
public final TablePosition<S,?> getEditingCell()
public final ReadOnlyObjectProperty<TablePosition<S,?>> editingCellProperty()
getEditingCell()
public final ObservableList<TableColumn<S,?>> getColumns()
Note: to display any data in a TableView, there must be at least one TableColumn in this ObservableList.
public final ObservableList<TableColumn<S,?>> getSortOrder()
TableColumn
instances
are sorted. An empty sortOrder list means that no sorting is being applied
on the TableView. If the sortOrder list has one TableColumn within it,
the TableView will be sorted using the
sortType
and
comparator
properties of this
TableColumn (assuming
TableColumn.sortable
is true).
If the sortOrder list contains multiple TableColumn instances, then
the TableView is firstly sorted based on the properties of the first
TableColumn. If two elements are considered equal, then the second
TableColumn in the list is used to determine ordering. This repeats until
the results from all TableColumn comparators are considered, if necessary.public void scrollTo(int index)
index
- The index of an item that should be visible to the user.public boolean resizeColumn(TableColumn<S,?> column, double delta)
public void edit(int row, TableColumn<S,?> column)
public ObservableList<TableColumn<S,?>> getVisibleLeafColumns()
public int getVisibleLeafIndex(TableColumn<S,?> column)
public TableColumn<S,?> getVisibleLeafColumn(int column)
Copyright (c) 2008, 2014, Oracle and/or its affiliates. All rights reserved.