TableCell

java.lang.Object
- Region
- - javafx.scene.control.Control
  - - javafx.scene.control.Labeled
    - - javafx.scene.control.Cell<T>
      - javafx.scene.control.IndexedCell<T>
        
        javafx.scene.control.TableCell<S,T>

Type Parameters:

S - The type of the TableView generic type (i.e. S == TableView<S>). This should also match with the first generic type in TableColumn.

T - The type of the item contained within the Cell.

All Implemented Interfaces:

Skinnable
```
public class TableCell<S,T>
extends IndexedCell<T>
```
Represents a single row/column intersection in a TableView. To represent this intersection, a TableCell contains an index property, as well as a tableColumn property. In addition, a TableCell instance knows what TableRow it exists in.
A note about selection: A TableCell visually shows it is selected when two conditions are met:
1. The TableSelectionModel.isSelected(int, TableColumnBase) method returns true for the row / column that this cell represents, and
2. The cell selection mode property is set to true (to represent that it is allowable to select individual cells (and not just rows of cells)).
Since:

JavaFX 2.0

See Also:

TableView, TableColumn, Cell, IndexedCell, TableRow

Property Summary

All Methods Instance Methods Concrete Methods
Type	Property and Description
`<any>`	`tableColumn` The TableColumn instance that backs this TableCell.
`<any>`	`tableRow` The TableRow that this TableCell currently finds itself placed within.
`<any>`	`tableView` The TableView associated with this TableCell.

Properties inherited from class javafx.scene.control.IndexedCell
indexProperty

Properties inherited from class javafx.scene.control.Cell
editableProperty, editingProperty, emptyProperty, itemProperty, selectedProperty

Properties inherited from class javafx.scene.control.Labeled
alignmentProperty, contentDisplayProperty, ellipsisStringProperty, fontProperty, graphicProperty, graphicTextGapProperty, labelPaddingProperty, lineSpacingProperty, mnemonicParsingProperty, textAlignmentProperty, textFillProperty, textOverrunProperty, textProperty, underlineProperty, wrapTextProperty

Properties inherited from class javafx.scene.control.Control
contextMenuProperty, skinClassNameProperty, skinProperty, tooltipProperty

Field Summary

Fields
Modifier and Type	Field and Description
`private InvalidationListener`	`columnIdListener`
`private int`	`columnIndex`
`private <any>`	`columnStyleClassListener`
`private InvalidationListener`	`columnStyleListener`
`private <any>`	`currentObservableValue`
`private static java.lang.String`	`DEFAULT_STYLE_CLASS` * Stylesheet Handling * *
`private InvalidationListener`	`editingListener`
`private InvalidationListener`	`focusedListener`
`private boolean`	`isFirstRun`
`private boolean`	`isLastVisibleColumn`
`private boolean`	`itemDirty` * Callbacks and Events * *
`(package private) boolean`	`lockItemOnEdit` * Private fields * *
`private java.lang.ref.WeakReference<S>`	`oldRowItemRef`
`private static PseudoClass`	`PSEUDO_CLASS_LAST_VISIBLE`
`private <any>`	`selectedListener`
`private <any>`	`tableColumn` * Properties * *
`private <any>`	`tableRow` The TableRow that this TableCell currently finds itself placed within.
`private InvalidationListener`	`tableRowUpdateObserver`
`private <any>`	`tableView`
`private boolean`	`updateEditingIndex`
`private <any>`	`visibleLeafColumnsListener`
`private WeakInvalidationListener`	`weakColumnIdListener`
`private <any>`	`weakColumnStyleClassListener`
`private WeakInvalidationListener`	`weakColumnStyleListener`
`private WeakInvalidationListener`	`weakEditingListener`
`private WeakInvalidationListener`	`weakFocusedListener`
`private <any>`	`weakSelectedListener`
`private WeakInvalidationListener`	`weaktableRowUpdateObserver`
`private <any>`	`weakVisibleLeafColumnsListener`

Constructor Summary

Constructors
Constructor and Description

TableCell()
Constructs a default TableCell instance with a style class of 'table-cell'

Constructors
Constructor and Description
`TableCell()` Constructs a default TableCell instance with a style class of 'table-cell'

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`cancelEdit()` Call this function to transition from an editing state into a non-editing state, without saving any user input.
`private void`	`cleanUpTableViewListeners(TableView<S> tableView)`
`void`	`commitEdit(T newValue)` Call this function when appropriate (based on the user interaction requirements of your cell editing user interface) to do two things: Fire the appropriate events back to the backing UI control (e.g.
`protected Skin<?>`	`createDefaultSkin()` Create a new instance of the default skin for this control.
`void`	`executeAccessibleAction(AccessibleAction action, java.lang.Object... parameters)`
`TableColumn<S,T>`	`getTableColumn()` Gets the value of the property tableColumn.
`TableRow<S>`	`getTableRow()` Gets the value of the property tableRow.
`TableView<S>`	`getTableView()` Gets the value of the property tableView.
`(package private) void`	`indexChanged(int oldIndex, int newIndex)` This method is called whenever the index is changed, regardless of whether the new index is the same as the old index.
`private boolean`	`isInCellSelectionMode()`
`protected void`	`layoutChildren()`
`private boolean`	`match(TablePosition<S,?> pos)`
`private void`	`possiblySetId(java.lang.String idCandidate)`
`private void`	`possiblySetStyle(java.lang.String styleCandidate)`
`java.lang.Object`	`queryAccessibleAttribute(AccessibleAttribute attribute, java.lang.Object... parameters)`
`private void`	`setTableColumn(TableColumn<S,T> value)`
`private void`	`setTableRow(TableRow<S> value)`
`private void`	`setTableView(TableView<S> value)`
`void`	`startEdit()` Call this function to transition from a non-editing state into an editing state, if the cell is editable.
`<any>`	`tableColumnProperty()` The TableColumn instance that backs this TableCell.
`<any>`	`tableRowProperty()` The TableRow that this TableCell currently finds itself placed within.
`<any>`	`tableViewProperty()` The TableView associated with this TableCell.
`private <any>`	`tableViewPropertyImpl()`
`private void`	`updateColumnIndex()`
`private void`	`updateEditing()`
`private void`	`updateFocus()`
`private void`	`updateItem(int oldIndex)`
`void`	`updateSelected(boolean selected)` Updates whether this cell is in a selected state or not.
`private void`	`updateSelection()`
`void`	`updateTableColumn(TableColumn col)` Updates the TableColumn associated with this TableCell.
`void`	`updateTableRow(TableRow tableRow)` Updates the TableRow associated with this TableCell.
`void`	`updateTableView(TableView tv)` Updates the TableView associated with this TableCell.

Methods inherited from class javafx.scene.control.IndexedCell
getIndex, indexProperty, updateIndex

Methods inherited from class javafx.scene.control.Cell
editableProperty, editingProperty, emptyProperty, getInitialFocusTraversable, getItem, isEditable, isEditing, isEmpty, isItemChanged, isSelected, itemProperty, selectedProperty, setEditable, setItem, setSelected, updateItem

Methods inherited from class javafx.scene.control.Labeled
alignmentProperty, contentDisplayProperty, ellipsisStringProperty, fontProperty, getAlignment, getClassCssMetaData, getContentBias, getContentDisplay, getControlCssMetaData, getEllipsisString, getFont, getGraphic, getGraphicTextGap, getInitialAlignment, getLabelPadding, getLineSpacing, getText, getTextAlignment, getTextFill, getTextOverrun, graphicProperty, graphicTextGapProperty, isMnemonicParsing, isUnderline, isWrapText, labelPaddingProperty, lineSpacingProperty, mnemonicParsingProperty, setAlignment, setContentDisplay, setEllipsisString, setFont, setGraphic, setGraphicTextGap, setLineSpacing, setMnemonicParsing, setText, setTextAlignment, setTextFill, setTextOverrun, setUnderline, setWrapText, textAlignmentProperty, textFillProperty, textOverrunProperty, textProperty, toString, underlineProperty, wrapTextProperty

Methods inherited from class javafx.scene.control.Control
computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, contextMenuProperty, getBaselineOffset, getContextMenu, getControlChildren, getCssMetaData, getSkin, getTooltip, isResizable, loadSkinClass, setContextMenu, setSkin, setTooltip, skinClassNameProperty, skinProperty, tooltipProperty

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

- Property Detail
  - tableColumn
```
public final <any> tableColumnProperty
```
    The TableColumn instance that backs this TableCell.
    
    Returns:
    
    the TableColumn instance that backs this TableCell
  - tableView
```
public final <any> tableViewProperty
```
    The TableView associated with this TableCell.
    
    See Also:
    
    getTableView()
  - tableRow
```
public final <any> tableRowProperty
```
    The TableRow that this TableCell currently finds itself placed within. The TableRow may be null early in the TableCell lifecycle, in the period between the TableCell being instantiated and being set into an owner TableRow.
    
    See Also:
    
    getTableRow()
- Field Detail
  - lockItemOnEdit
```
boolean lockItemOnEdit
```
    * Private fields * *
  - itemDirty
```
private boolean itemDirty
```
    * Callbacks and Events * *
  - selectedListener
```
private <any> selectedListener
```
  - focusedListener
```
private final InvalidationListener focusedListener
```
  - tableRowUpdateObserver
```
private final InvalidationListener tableRowUpdateObserver
```
  - editingListener
```
private final InvalidationListener editingListener
```
  - visibleLeafColumnsListener
```
private <any> visibleLeafColumnsListener
```
  - columnStyleClassListener
```
private <any> columnStyleClassListener
```
  - columnStyleListener
```
private final InvalidationListener columnStyleListener
```
  - columnIdListener
```
private final InvalidationListener columnIdListener
```
  - weakSelectedListener
```
private final <any> weakSelectedListener
```
  - weakFocusedListener
```
private final WeakInvalidationListener weakFocusedListener
```
  - weaktableRowUpdateObserver
```
private final WeakInvalidationListener weaktableRowUpdateObserver
```
  - weakEditingListener
```
private final WeakInvalidationListener weakEditingListener
```
  - weakColumnStyleListener
```
private final WeakInvalidationListener weakColumnStyleListener
```
  - weakColumnIdListener
```
private final WeakInvalidationListener weakColumnIdListener
```
  - weakVisibleLeafColumnsListener
```
private final <any> weakVisibleLeafColumnsListener
```
  - weakColumnStyleClassListener
```
private final <any> weakColumnStyleClassListener
```
  - tableColumn
```
private <any> tableColumn
```
    * Properties * *
  - tableView
```
private <any> tableView
```
  - tableRow
```
private <any> tableRow
```
    The TableRow that this TableCell currently finds itself placed within. The TableRow may be null early in the TableCell lifecycle, in the period between the TableCell being instantiated and being set into an owner TableRow.
  - isLastVisibleColumn
```
private boolean isLastVisibleColumn
```
  - columnIndex
```
private int columnIndex
```
  - updateEditingIndex
```
private boolean updateEditingIndex
```
  - currentObservableValue
```
private <any> currentObservableValue
```
  - isFirstRun
```
private boolean isFirstRun
```
  - oldRowItemRef
```
private java.lang.ref.WeakReference<S> oldRowItemRef
```
  - DEFAULT_STYLE_CLASS
```
private static final java.lang.String DEFAULT_STYLE_CLASS
```
    * Stylesheet Handling * *
    
    See Also:
    
    Constant Field Values
  - PSEUDO_CLASS_LAST_VISIBLE
```
private static final PseudoClass PSEUDO_CLASS_LAST_VISIBLE
```
- Constructor Detail
  - TableCell
```
public TableCell()
```
    Constructs a default TableCell instance with a style class of 'table-cell'
- Method Detail
  - tableColumnProperty
```
public final <any> tableColumnProperty()
```
    The TableColumn instance that backs this TableCell.
    
    Returns:
    
    the TableColumn instance that backs this TableCell
  - setTableColumn
```
private void setTableColumn(TableColumn<S,T> value)
```
  - getTableColumn
```
public final TableColumn<S,T> getTableColumn()
```
    Gets the value of the property tableColumn.
  - setTableView
```
private void setTableView(TableView<S> value)
```
  - getTableView
```
public final TableView<S> getTableView()
```
    Gets the value of the property tableView.
  - tableViewProperty
```
public final <any> tableViewProperty()
```
    The TableView associated with this TableCell.
    
    See Also:
    
    getTableView()
  - tableViewPropertyImpl
```
private <any> tableViewPropertyImpl()
```
  - setTableRow
```
private void setTableRow(TableRow<S> value)
```
  - getTableRow
```
public final TableRow<S> getTableRow()
```
    Gets the value of the property tableRow.
  - tableRowProperty
```
public final <any> tableRowProperty()
```
    The TableRow that this TableCell currently finds itself placed within. The TableRow may be null early in the TableCell lifecycle, in the period between the TableCell being instantiated and being set into an owner TableRow.
    
    See Also:
    
    getTableRow()
  - startEdit
```
public void startEdit()
```
    Call this function to transition from a non-editing state into an editing state, if the cell is editable. If this cell is already in an editing state, it will stay in it.
    
    Overrides:
    
    startEdit in class Cell<T>
  - commitEdit
```
public void commitEdit(T newValue)
```
    Call this function when appropriate (based on the user interaction requirements of your cell editing user interface) to do two things:
    1. Fire the appropriate events back to the backing UI control (e.g. ListView). This will begin the process of pushing this edit back to the relevant data source / property (although it does not guarantee that this will be successful - that is dependent upon the specific edit commit handler being used). Refer to the UI control class javadoc for more detail.
    2. Begin the transition from an editing state into a non-editing state.
    In general there is no need to override this method in custom cell implementations - it should be sufficient to simply call this method when appropriate (e.g. when the user pressed the Enter key, you may do something like cell.commitEdit(converter.fromString(textField.getText()));
    Overrides:
    
    commitEdit in class Cell<T>
    
    Parameters:
    
    newValue - The value as input by the end user, which should be persisted in the relevant way given the data source underpinning the user interface and the install edit commit handler of the UI control.
  - cancelEdit
```
public void cancelEdit()
```
    Call this function to transition from an editing state into a non-editing state, without saving any user input.
    
    Overrides:
    
    cancelEdit in class Cell<T>
  - updateSelected
```
public void updateSelected(boolean selected)
```
    Updates whether this cell is in a selected state or not.
    
    Overrides:
    
    updateSelected in class Cell<T>
    
    Parameters:
    
    selected - whether or not to select this cell.
  - createDefaultSkin
```
protected Skin<?> createDefaultSkin()
```
    Create a new instance of the default skin for this control. This is called to create a skin for the control if no skin is provided via CSS -fx-skin or set explicitly in a sub-class with setSkin(...).
    
    Overrides:
    
    createDefaultSkin in class Control
    
    Returns:
    
    new instance of default skin for this control. If null then the control will have no skin unless one is provided by css.
  - cleanUpTableViewListeners
```
private void cleanUpTableViewListeners(TableView<S> tableView)
```
  - indexChanged
```
void indexChanged(int oldIndex,
                  int newIndex)
```
    Description copied from class: IndexedCell
    
    This method is called whenever the index is changed, regardless of whether the new index is the same as the old index.
    
    Overrides:
    
    indexChanged in class IndexedCell<T>
  - updateColumnIndex
```
private void updateColumnIndex()
```
  - updateSelection
```
private void updateSelection()
```
  - updateFocus
```
private void updateFocus()
```
  - updateEditing
```
private void updateEditing()
```
  - match
```
private boolean match(TablePosition<S,?> pos)
```
  - isInCellSelectionMode
```
private boolean isInCellSelectionMode()
```
  - updateItem
```
private void updateItem(int oldIndex)
```
  - layoutChildren
```
protected void layoutChildren()
```
    Description copied from class: Cell
    
    Overrides:
    
    layoutChildren in class Cell<T>
  - updateTableView
```
public final void updateTableView(TableView tv)
```
    Updates the TableView associated with this TableCell. This is typically only done once when the TableCell is first added to the TableView. Note: This function is intended to be used by experts, primarily by those implementing new Skins. It is not common for developers or designers to access this function directly.
    
    Parameters:
    
    tv - the TableView associated with this TableCell
  - updateTableRow
```
public final void updateTableRow(TableRow tableRow)
```
    Updates the TableRow associated with this TableCell. Note: This function is intended to be used by experts, primarily by those implementing new Skins. It is not common for developers or designers to access this function directly.
    
    Parameters:
    
    tableRow - the TableRow associated with this TableCell
  - updateTableColumn
```
public final void updateTableColumn(TableColumn col)
```
    Updates the TableColumn associated with this TableCell. Note: This function is intended to be used by experts, primarily by those implementing new Skins. It is not common for developers or designers to access this function directly.
    
    Parameters:
    
    col - the TableColumn associated with this TableCell
  - possiblySetId
```
private void possiblySetId(java.lang.String idCandidate)
```
  - possiblySetStyle
```
private void possiblySetStyle(java.lang.String styleCandidate)
```
  - queryAccessibleAttribute
```
public java.lang.Object queryAccessibleAttribute(AccessibleAttribute attribute,
                                                 java.lang.Object... parameters)
```
    Overrides:
    
    queryAccessibleAttribute in class Control
  - executeAccessibleAction
```
public void executeAccessibleAction(AccessibleAction action,
                                    java.lang.Object... parameters)
```
    Overrides:
    
    executeAccessibleAction in class Control

Class TableCell<S,T>

Property Summary

Properties inherited from class javafx.scene.control.IndexedCell

Properties inherited from class javafx.scene.control.Cell

Properties inherited from class javafx.scene.control.Labeled

Properties inherited from class javafx.scene.control.Control

Field Summary

Constructor Summary

Method Summary

Methods inherited from class javafx.scene.control.IndexedCell

Methods inherited from class javafx.scene.control.Cell

Methods inherited from class javafx.scene.control.Labeled

Methods inherited from class javafx.scene.control.Control

Methods inherited from class java.lang.Object

Property Detail

tableColumn

tableView

tableRow

Field Detail

lockItemOnEdit

itemDirty

selectedListener

focusedListener

tableRowUpdateObserver

editingListener

visibleLeafColumnsListener

columnStyleClassListener

columnStyleListener

columnIdListener

weakSelectedListener

weakFocusedListener

weaktableRowUpdateObserver

weakEditingListener

weakColumnStyleListener

weakColumnIdListener

weakVisibleLeafColumnsListener

weakColumnStyleClassListener

tableColumn

tableView

tableRow

isLastVisibleColumn

columnIndex

updateEditingIndex

currentObservableValue

isFirstRun

oldRowItemRef

DEFAULT_STYLE_CLASS

PSEUDO_CLASS_LAST_VISIBLE

Constructor Detail

TableCell

Method Detail

tableColumnProperty

setTableColumn

getTableColumn

setTableView

getTableView

tableViewProperty

tableViewPropertyImpl

setTableRow

getTableRow

tableRowProperty

startEdit

commitEdit

cancelEdit

updateSelected

createDefaultSkin

cleanUpTableViewListeners

indexChanged

updateColumnIndex

updateSelection

updateFocus

updateEditing

match

isInCellSelectionMode

updateItem

layoutChildren

updateTableView

updateTableRow

updateTableColumn

possiblySetId