javafx.scene.control.cell

Class TextFieldTableCell<S,T>

java.lang.Object

<any>

javafx.scene.control.cell.TextFieldTableCell<S,T>

Type Parameters:

S - The type of the TableView generic type

T - The type of the elements contained within the TableColumn.

public class TextFieldTableCell<S,T>
extends <any>

A class containing a TableCell implementation that draws a TextField node inside the cell.

By default, the TextFieldTableCell is rendered as a Label when not being edited, and as a TextField when in editing mode. The TextField will, by default, stretch to fill the entire table cell.

Since:

JavaFX 2.2

Property Summary

Type	Property and Description
<any>	converter The StringConverter property.

Field Summary

Fields

Modifier and Type	Field and Description
private <any>	converter * Properties * *
private TextField	textField * Fields * *

Constructor Summary

Constructors

Constructor and Description
TextFieldTableCell() Creates a default TextFieldTableCell with a null converter.
TextFieldTableCell(<any> converter) Creates a TextFieldTableCell that provides a TextField when put into editing mode that allows editing of the cell content.

Method Summary

Modifier and Type	Method and Description
void	cancelEdit()
<any>	converterProperty() The StringConverter property.
static <S> <any>	forTableColumn() Provides a TextField that allows editing of the cell content when the cell is double-clicked, or when TableView#edit(int, javafx.scene.control.TableColumn) is called.
static <S,T> <any>	forTableColumn(<any> converter) Provides a TextField that allows editing of the cell content when the cell is double-clicked, or when TableView#edit(int, javafx.scene.control.TableColumn) is called.
<any>	getConverter() Returns the StringConverter used in this cell.
void	setConverter(<any> value) Sets the StringConverter to be used in this cell.
void	startEdit()
void	updateItem(T item, boolean empty)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Property Detail

converter

public final <any> converterProperty

The StringConverter property.

Returns:

the StringConverter property

Field Detail

textField

private TextField textField

* Fields * *

converter

private <any> converter

* Properties * *

Constructor Detail

TextFieldTableCell

public TextFieldTableCell()

Creates a default TextFieldTableCell with a null converter. Without a StringConverter specified, this cell will not be able to accept input from the TextField (as it will not know how to convert this back to the domain object). It is therefore strongly encouraged to not use this constructor unless you intend to set the converter separately.

TextFieldTableCell

public TextFieldTableCell(<any> converter)

Creates a TextFieldTableCell that provides a TextField when put into editing mode that allows editing of the cell content. This method will work on any TableColumn instance, regardless of its generic type. However, to enable this, a StringConverter must be provided that will convert the given String (from what the user typed in) into an instance of type T. This item will then be passed along to the TableColumn#onEditCommitProperty() callback.

Parameters:

converter - A converter that can convert the given String (from what the user typed in) into an instance of type T.

Method Detail

forTableColumn

public static <S> <any> forTableColumn()

Provides a TextField that allows editing of the cell content when the cell is double-clicked, or when TableView#edit(int, javafx.scene.control.TableColumn) is called. This method will only work on TableColumn instances which are of type String.

Type Parameters:

S - The type of the TableView generic type

Returns:

A Callback that can be inserted into the cell factory property of a TableColumn, that enables textual editing of the content.

forTableColumn

public static <S,T> <any> forTableColumn(<any> converter)

Provides a TextField that allows editing of the cell content when the cell is double-clicked, or when TableView#edit(int, javafx.scene.control.TableColumn) is called. This method will work on any TableColumn instance, regardless of its generic type. However, to enable this, a StringConverter must be provided that will convert the given String (from what the user typed in) into an instance of type T. This item will then be passed along to the TableColumn#onEditCommitProperty() callback.

Type Parameters:

S - The type of the TableView generic type

T - The type of the elements contained within the TableColumn

Parameters:

converter - A StringConverter that can convert the given String (from what the user typed in) into an instance of type T.

Returns:

A Callback that can be inserted into the cell factory property of a TableColumn, that enables textual editing of the content.

converterProperty

public final <any> converterProperty()

The StringConverter property.

Returns:

the StringConverter property

setConverter

public final void setConverter(<any> value)

Sets the StringConverter to be used in this cell.

Parameters:

value - the StringConverter to be used in this cell

getConverter

public final <any> getConverter()

Returns the StringConverter used in this cell.

Returns:

the StringConverter used in this cell

startEdit

public void startEdit()

cancelEdit

public void cancelEdit()

updateItem

public void updateItem(T item,
                       boolean empty)