TableView (JavaFX 2.2)

java.lang.Object
- javafx.scene.Node
- - javafx.scene.Parent
  - - javafx.scene.control.Control
    - - javafx.scene.control.TableView<S>

Type Parameters:
S - The type of the objects contained within the TableView items list.

All Implemented Interfaces:

EventTarget, Skinnable
```
@DefaultProperty(value="items")
public class TableView<S>
extends Control
```
The TableView control is designed to visualize an unlimited number of rows of data, broken out into columns. A TableView is therefore very similar to the 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:
- Powerful TableColumn API:
  - Support for cell factories to easily customize cell contents in both rendering and editing states.
  - Specification of minWidth/ prefWidth/maxWidth, and also fixed width columns.
  - Width resizing by the user at runtime.
  - Column reordering by the user at runtime.
  - Built-in support for column nesting
- Different resizing policies to dictate what happens when the user resizes columns.
- Support for 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

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, as it is the simplest way of showing data in a TableView. 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; 
     } 
 }
```
Firstly, a TableView instance needs to be defined, as such:
```
 TableView<Person> table = new TableView<Person>();
```
With the basic table defined, we next focus on the data model. As mentioned, for this example, we'll be using a ObservableList. We can immediately set such a list directly in to the TableView, as such:
```
 ObservableList<Person> teamMembers = getTeamMembers();
 table.setItems(teamMembers);
```
With the items set as such, TableView will automatically update whenever the teamMembers list changes. If the items list is available before the TableView is instantiated, it is possible to pass it directly into the constructor.
At this point we now have a TableView hooked up to observe the 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);
```
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.
TableView support for classes that don't contain properties

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, 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

To track selection and focus, it is necessary to become familiar with the 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.
The default 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

The visuals of the TableView can be entirely customized by replacing the default row factory. A row factory is used to generate TableRow instances, which are used to represent an entire row in the TableView.
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 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.
You can create custom TableCell instances per column by assigning the appropriate function to the TableColumn cell factory property.
See the Cell class documentation for a more complete description of how to write custom Cells.
See Also:
TableColumn, TablePosition

Property Summary

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

Properties inherited from class javafx.scene.control.Control
contextMenu, height, maxHeight, maxWidth, minHeight, minWidth, prefHeight, prefWidth, skinClassName, skin, tooltip, width

Properties inherited from class javafx.scene.Parent
needsLayout

Properties inherited from class javafx.scene.Node
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

Nested Class Summary

Nested Classes
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.

Field Summary

Fields
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).

Fields inherited from class javafx.scene.control.Control
USE_COMPUTED_SIZE, USE_PREF_SIZE

Constructor Summary

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

Method Summary

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

Methods inherited from class javafx.scene.control.Control
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

Methods inherited from class javafx.scene.Parent
getChildren, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, lookup, needsLayoutProperty, requestLayout, setNeedsLayout

Methods inherited from class javafx.scene.Node
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

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Property Detail
  - items
```
public final ObjectProperty<ObservableList<S>> itemsProperty
```
    The underlying data model for the TableView. Note that it has a generic type that must match the type of the TableView itself.
    
    See Also:
    getItems(), setItems(ObservableList)
  - tableMenuButtonVisible
```
public final 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. This menu allows for the user to show and hide all TableColumns easily.
    
    See Also:
    isTableMenuButtonVisible(), setTableMenuButtonVisible(boolean)
  - columnResizePolicy
```
public final ObjectProperty<Callback<TableView.ResizeFeatures,java.lang.Boolean>> columnResizePolicyProperty
```
    This is the function called when the user completes a column-resize operation. The two most common policies are available as static functions in the TableView class: UNCONSTRAINED_RESIZE_POLICY and CONSTRAINED_RESIZE_POLICY.
    
    See Also:
    getColumnResizePolicy(), setColumnResizePolicy(Callback)
  - rowFactory
```
public final ObjectProperty<Callback<TableView<S>,TableRow<S>>> rowFactoryProperty
```
    A function which produces a TableRow. The system is responsible for reusing TableRows. Return from this function a TableRow which might be usable for representing a single row in a TableView.
    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.
    
    See Also:
    getRowFactory(), setRowFactory(Callback)
  - placeholder
```
public final ObjectProperty<Node> placeholderProperty
```
    This Node is shown to the user when the table has no content to show. This may be the case because the table model has no data in the first place, that a filter has been applied to the table model, resulting in there being nothing to show the user, or that there are no currently visible columns.
    
    See Also:
    getPlaceholder(), setPlaceholder(Node)
  - selectionModel
```
public final 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. Note that it has a generic type that must match the type of the TableView itself.
    
    See Also:
    getSelectionModel(), setSelectionModel(TableViewSelectionModel)
  - focusModel
```
public final ObjectProperty<TableView.TableViewFocusModel<S>> focusModelProperty
```
    Represents the currently-installed TableView.TableViewFocusModel for this TableView. Under almost all circumstances leaving this as the default focus model will suffice.
    
    See Also:
    getFocusModel(), setFocusModel(TableViewFocusModel)
  - editable
```
public final 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.
    
    See Also:
    isEditable(), setEditable(boolean)
  - editingCell
```
public final ReadOnlyObjectProperty<TablePosition<S,?>> editingCellProperty
```
    Represents the current cell being edited, or null if there is no cell being edited.
    
    See Also:
    getEditingCell()
- Field Detail
  - UNCONSTRAINED_RESIZE_POLICY
```
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.
  - CONSTRAINED_RESIZE_POLICY
```
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.
- Constructor Detail
  - TableView
```
public TableView()
```
    Creates a default TableView control with no content.
    Refer to the TableView class documentation for details on the default state of other properties.
  - TableView
```
public TableView(ObservableList<S> items)
```
    Creates a TableView with the content provided in the items ObservableList. This also sets up an observer such that any changes to the items list will be immediately reflected in the TableView itself.
    Refer to the TableView class documentation for details on the default state of other properties.
    
    Parameters:
    items - The items to insert into the TableView, and the list to watch for changes (to automatically show in the TableView).
- Method Detail
  - itemsProperty
```
public final ObjectProperty<ObservableList<S>> itemsProperty()
```
    The underlying data model for the TableView. Note that it has a generic type that must match the type of the TableView itself.
    
    See Also:
    getItems(), setItems(ObservableList)
  - setItems
```
public final void setItems(ObservableList<S> value)
```
    Sets the value of the property items.
    
    Property description:
    
    The underlying data model for the TableView. Note that it has a generic type that must match the type of the TableView itself.
  - getItems
```
public final ObservableList<S> getItems()
```
    Gets the value of the property items.
    
    Property description:
    
    The underlying data model for the TableView. Note that it has a generic type that must match the type of the TableView itself.
  - tableMenuButtonVisibleProperty
```
public final 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. This menu allows for the user to show and hide all TableColumns easily.
    
    See Also:
    isTableMenuButtonVisible(), setTableMenuButtonVisible(boolean)
  - setTableMenuButtonVisible
```
public final void setTableMenuButtonVisible(boolean value)
```
    Sets the value of the property tableMenuButtonVisible.
    
    Property description:
    
    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. This menu allows for the user to show and hide all TableColumns easily.
  - isTableMenuButtonVisible
```
public final boolean isTableMenuButtonVisible()
```
    Gets the value of the property tableMenuButtonVisible.
    
    Property description:
    
    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. This menu allows for the user to show and hide all TableColumns easily.
  - setColumnResizePolicy
```
public final void setColumnResizePolicy(Callback<TableView.ResizeFeatures,java.lang.Boolean> callback)
```
    Sets the value of the property columnResizePolicy.
    
    Property description:
    
    This is the function called when the user completes a column-resize operation. The two most common policies are available as static functions in the TableView class: UNCONSTRAINED_RESIZE_POLICY and CONSTRAINED_RESIZE_POLICY.
  - getColumnResizePolicy
```
public final Callback<TableView.ResizeFeatures,java.lang.Boolean> getColumnResizePolicy()
```
    Gets the value of the property columnResizePolicy.
    
    Property description:
    
    This is the function called when the user completes a column-resize operation. The two most common policies are available as static functions in the TableView class: UNCONSTRAINED_RESIZE_POLICY and CONSTRAINED_RESIZE_POLICY.
  - columnResizePolicyProperty
```
public final ObjectProperty<Callback<TableView.ResizeFeatures,java.lang.Boolean>> columnResizePolicyProperty()
```
    This is the function called when the user completes a column-resize operation. The two most common policies are available as static functions in the TableView class: UNCONSTRAINED_RESIZE_POLICY and CONSTRAINED_RESIZE_POLICY.
    
    See Also:
    getColumnResizePolicy(), setColumnResizePolicy(Callback)
  - rowFactoryProperty
```
public final ObjectProperty<Callback<TableView<S>,TableRow<S>>> rowFactoryProperty()
```
    A function which produces a TableRow. The system is responsible for reusing TableRows. Return from this function a TableRow which might be usable for representing a single row in a TableView.
    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.
    
    See Also:
    getRowFactory(), setRowFactory(Callback)
  - setRowFactory
```
public final void setRowFactory(Callback<TableView<S>,TableRow<S>> value)
```
    Sets the value of the property rowFactory.
    
    Property description:
    
    A function which produces a TableRow. The system is responsible for reusing TableRows. Return from this function a TableRow which might be usable for representing a single row in a TableView.
    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
```
public final Callback<TableView<S>,TableRow<S>> getRowFactory()
```
    Gets the value of the property rowFactory.
    
    Property description:
    
    A function which produces a TableRow. The system is responsible for reusing TableRows. Return from this function a TableRow which might be usable for representing a single row in a TableView.
    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.
  - placeholderProperty
```
public final ObjectProperty<Node> placeholderProperty()
```
    This Node is shown to the user when the table has no content to show. This may be the case because the table model has no data in the first place, that a filter has been applied to the table model, resulting in there being nothing to show the user, or that there are no currently visible columns.
    
    See Also:
    getPlaceholder(), setPlaceholder(Node)
  - setPlaceholder
```
public final void setPlaceholder(Node value)
```
    Sets the value of the property placeholder.
    
    Property description:
    
    This Node is shown to the user when the table has no content to show. This may be the case because the table model has no data in the first place, that a filter has been applied to the table model, resulting in there being nothing to show the user, or that there are no currently visible columns.
  - getPlaceholder
```
public final Node getPlaceholder()
```
    Gets the value of the property placeholder.
    
    Property description:
    
    This Node is shown to the user when the table has no content to show. This may be the case because the table model has no data in the first place, that a filter has been applied to the table model, resulting in there being nothing to show the user, or that there are no currently visible columns.
  - selectionModelProperty
```
public final 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. Note that it has a generic type that must match the type of the TableView itself.
    
    See Also:
    getSelectionModel(), setSelectionModel(TableViewSelectionModel)
  - setSelectionModel
```
public final void setSelectionModel(TableView.TableViewSelectionModel<S> value)
```
    Sets the value of the property selectionModel.
    
    Property description:
    
    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. Note that it has a generic type that must match the type of the TableView itself.
  - getSelectionModel
```
public final TableView.TableViewSelectionModel<S> getSelectionModel()
```
    Gets the value of the property selectionModel.
    
    Property description:
    
    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. Note that it has a generic type that must match the type of the TableView itself.
  - setFocusModel
```
public final void setFocusModel(TableView.TableViewFocusModel<S> value)
```
    Sets the value of the property focusModel.
    
    Property description:
    
    Represents the currently-installed TableView.TableViewFocusModel for this TableView. Under almost all circumstances leaving this as the default focus model will suffice.
  - getFocusModel
```
public final TableView.TableViewFocusModel<S> getFocusModel()
```
    Gets the value of the property focusModel.
    
    Property description:
    
    Represents the currently-installed TableView.TableViewFocusModel for this TableView. Under almost all circumstances leaving this as the default focus model will suffice.
  - focusModelProperty
```
public final ObjectProperty<TableView.TableViewFocusModel<S>> focusModelProperty()
```
    Represents the currently-installed TableView.TableViewFocusModel for this TableView. Under almost all circumstances leaving this as the default focus model will suffice.
    
    See Also:
    getFocusModel(), setFocusModel(TableViewFocusModel)
  - setEditable
```
public final void setEditable(boolean value)
```
    Sets the value of the property editable.
    
    Property description:
    
    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.
  - isEditable
```
public final boolean isEditable()
```
    Gets the value of the property editable.
    
    Property description:
    
    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.
  - editableProperty
```
public final 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.
    
    See Also:
    isEditable(), setEditable(boolean)
  - getEditingCell
```
public final TablePosition<S,?> getEditingCell()
```
    Gets the value of the property editingCell.
    
    Property description:
    
    Represents the current cell being edited, or null if there is no cell being edited.
  - editingCellProperty
```
public final ReadOnlyObjectProperty<TablePosition<S,?>> editingCellProperty()
```
    Represents the current cell being edited, or null if there is no cell being edited.
    
    See Also:
    getEditingCell()
  - getColumns
```
public final ObservableList<TableColumn<S,?>> getColumns()
```
    The TableColumns that are part of this TableView. As the user reorders the TableView columns, this list will be updated to reflect the current visual ordering.
    Note: to display any data in a TableView, there must be at least one TableColumn in this ObservableList.
  - getSortOrder
```
public final ObservableList<TableColumn<S,?>> getSortOrder()
```
    The sortOrder list defines the order in which 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.
    
    Returns:
    An ObservableList containing zero or more TableColumn instances.
  - scrollTo
```
public void scrollTo(int index)
```
    Scrolls the TableView so that the given index is visible within the viewport.
    
    Parameters:
    index - The index of an item that should be visible to the user.
  - resizeColumn
```
public 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.
  - edit
```
public 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.
  - getVisibleLeafColumns
```
public ObservableList<TableColumn<S,?>> getVisibleLeafColumns()
```
    Returns an unmodifiable list containing the currently visible leaf columns.
  - getVisibleLeafIndex
```
public int getVisibleLeafIndex(TableColumn<S,?> column)
```
    Returns the position of the given column, relative to all other visible leaf columns.
  - getVisibleLeafColumn
```
public TableColumn<S,?> getVisibleLeafColumn(int column)
```
    Returns the TableColumn in the given column index, relative to all other visible leaf columns.

Class TableView<S>

Creating a TableView

TableView support for classes that don't contain properties

TableView Selection / Focus APIs

Customizing TableView Visuals

Property Summary

Properties inherited from class javafx.scene.control.Control

Properties inherited from class javafx.scene.Parent

Properties inherited from class javafx.scene.Node

Nested Class Summary

Field Summary

Fields inherited from class javafx.scene.control.Control

Constructor Summary

Method Summary

Methods inherited from class javafx.scene.control.Control

Methods inherited from class javafx.scene.Parent

Methods inherited from class javafx.scene.Node

Methods inherited from class java.lang.Object

Property Detail

items

tableMenuButtonVisible

columnResizePolicy

rowFactory

placeholder

selectionModel

focusModel

editable

editingCell

Field Detail

UNCONSTRAINED_RESIZE_POLICY

CONSTRAINED_RESIZE_POLICY

Constructor Detail

TableView

TableView

Method Detail

itemsProperty

setItems

getItems

tableMenuButtonVisibleProperty

setTableMenuButtonVisible

isTableMenuButtonVisible

setColumnResizePolicy

getColumnResizePolicy

columnResizePolicyProperty

rowFactoryProperty

setRowFactory

getRowFactory

placeholderProperty

setPlaceholder

getPlaceholder

selectionModelProperty

setSelectionModel

getSelectionModel

setFocusModel

getFocusModel

focusModelProperty

setEditable

isEditable

editableProperty

getEditingCell

editingCellProperty

getColumns

getSortOrder

scrollTo

resizeColumn

edit

getVisibleLeafColumns

getVisibleLeafIndex

getVisibleLeafColumn