javafx.scene.control

Class TextField

java.lang.Object

Region

javafx.scene.control.Control

javafx.scene.control.TextInputControl

javafx.scene.control.TextField

All Implemented Interfaces:

Skinnable

Direct Known Subclasses:

PasswordField

public class TextField
extends TextInputControl

Text input component that allows a user to enter a single line of unformatted text. Unlike in previous releases of JavaFX, support for multi-line input is not available as part of the TextField control, however this is the sole-purpose of the TextArea control. Additionally, if you want a form of rich-text editing, there is also the HTMLEditor control.

TextField supports the notion of showing prompt text to the user when there is no text already in the TextField (either via the user, or set programmatically). This is a useful way of informing the user as to what is expected in the text field, without having to resort to tooltips or on-screen labels.

Since:

JavaFX 2.0

See Also:

TextArea

Property Summary

Type	Property and Description
<any>	alignment Specifies how the text should be aligned when there is empty space within the TextField.
<any>	onAction The action handler associated with this text field, or null if no action handler is assigned.
IntegerProperty	prefColumnCount The preferred number of text columns.

Properties inherited from class javafx.scene.control.TextInputControl

anchorProperty, caretPositionProperty, editableProperty, fontProperty, lengthProperty, promptTextProperty, redoableProperty, selectedTextProperty, selectionProperty, textFormatterProperty, textProperty, undoableProperty

Properties inherited from class javafx.scene.control.Control

contextMenuProperty, skinClassNameProperty, skinProperty, tooltipProperty

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	TextField.StyleableProperties * Stylesheet Handling * *
private static class	TextField.TextFieldContent

Nested classes/interfaces inherited from class javafx.scene.control.TextInputControl

TextInputControl.Content, TextInputControl.UndoRedoChange

Field Summary

Fields

Modifier and Type	Field and Description
private <any>	alignment
static int	DEFAULT_PREF_COLUMN_COUNT The default value for prefColumnCount.
private <any>	onAction The action handler associated with this text field, or null if no action handler is assigned.
private IntegerProperty	prefColumnCount The preferred number of text columns.

Constructor Summary

Constructors

Constructor and Description
TextField() Creates a TextField with empty text content.
TextField(java.lang.String text) Creates a TextField with initial text content.

Method Summary

Modifier and Type	Method and Description
<any>	alignmentProperty() Specifies how the text should be aligned when there is empty space within the TextField.
protected Skin<?>	createDefaultSkin() Create a new instance of the default skin for this control.
Pos	getAlignment() Gets the value of the property alignment.
java.lang.CharSequence	getCharacters() Returns the character sequence backing the text field's content.
static java.util.List<<any>>	getClassCssMetaData()
java.util.List<<any>>	getControlCssMetaData()
<any>	getOnAction() Gets the value of the property onAction.
int	getPrefColumnCount() Gets the value of the property prefColumnCount.
<any>	onActionProperty() The action handler associated with this text field, or null if no action handler is assigned.
IntegerProperty	prefColumnCountProperty() The preferred number of text columns.
void	setAlignment(Pos value) Sets the value of the property alignment.
void	setOnAction(<any> value) Sets the value of the property onAction.
void	setPrefColumnCount(int value) Sets the value of the property prefColumnCount.

Methods inherited from class javafx.scene.control.TextInputControl

anchorProperty, appendText, backward, cancelEdit, caretPositionProperty, clear, commitValue, containsInvalidCharacters, copy, cut, deleteNextChar, deletePreviousChar, deleteText, deleteText, deselect, editableProperty, end, endOfNextWord, executeAccessibleAction, extendSelection, filterInput, fontProperty, forward, getAnchor, getCaretPosition, getContent, getFont, getLength, getPromptText, getSelectedText, getSelection, getText, getText, getTextFormatter, home, insertText, isEditable, isRedoable, isUndoable, lengthProperty, nextWord, paste, positionCaret, previousWord, promptTextProperty, queryAccessibleAttribute, redo, redoableProperty, replaceSelection, replaceText, replaceText, selectAll, selectBackward, selectedTextProperty, selectEnd, selectEndOfNextWord, selectForward, selectHome, selectionProperty, selectNextWord, selectPositionCaret, selectPreviousWord, selectRange, setEditable, setFont, setPromptText, setText, setTextFormatter, textFormatterProperty, textProperty, textUpdated, undo, undoableProperty

Methods inherited from class javafx.scene.control.Control

computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, contextMenuProperty, getBaselineOffset, getContextMenu, getControlChildren, getCssMetaData, getInitialFocusTraversable, getSkin, getTooltip, isResizable, layoutChildren, loadSkinClass, setContextMenu, setSkin, setTooltip, skinClassNameProperty, skinProperty, tooltipProperty

Methods inherited from class java.lang.Object

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

Property Detail

prefColumnCount

public final IntegerProperty prefColumnCountProperty

The preferred number of text columns. This is used for calculating the TextField's preferred width.

See Also:

getPrefColumnCount(), setPrefColumnCount(int)

onAction

public final <any> onActionProperty

The action handler associated with this text field, or null if no action handler is assigned. The action handler is normally called when the user types the ENTER key.

See Also:

getOnAction(), #setOnAction()

alignment

public final <any> alignmentProperty

Specifies how the text should be aligned when there is empty space within the TextField.

Since:

JavaFX 2.1

See Also:

getAlignment(), setAlignment(Pos)

Field Detail

DEFAULT_PREF_COLUMN_COUNT

public static final int DEFAULT_PREF_COLUMN_COUNT

The default value for prefColumnCount.

See Also:

Constant Field Values

prefColumnCount

private IntegerProperty prefColumnCount

The preferred number of text columns. This is used for calculating the TextField's preferred width.

onAction

private <any> onAction

The action handler associated with this text field, or null if no action handler is assigned. The action handler is normally called when the user types the ENTER key.

alignment

private <any> alignment

Constructor Detail

TextField

public TextField()

Creates a TextField with empty text content.

TextField

public TextField(java.lang.String text)

Creates a TextField with initial text content.

Parameters:

text - A string for text content.

Method Detail

getCharacters

public java.lang.CharSequence getCharacters()

Returns the character sequence backing the text field's content.

Returns:

the character sequence backing the text field's content

prefColumnCountProperty

public final IntegerProperty prefColumnCountProperty()

The preferred number of text columns. This is used for calculating the TextField's preferred width.

See Also:

getPrefColumnCount(), setPrefColumnCount(int)

getPrefColumnCount

public final int getPrefColumnCount()

Gets the value of the property prefColumnCount.

setPrefColumnCount

public final void setPrefColumnCount(int value)

Sets the value of the property prefColumnCount.

onActionProperty

public final <any> onActionProperty()

The action handler associated with this text field, or null if no action handler is assigned. The action handler is normally called when the user types the ENTER key.

See Also:

getOnAction(), #setOnAction()

getOnAction

public final <any> getOnAction()

Gets the value of the property onAction.

setOnAction

public final void setOnAction(<any> value)

Sets the value of the property onAction.

alignmentProperty

public final <any> alignmentProperty()

Specifies how the text should be aligned when there is empty space within the TextField.

Since:

JavaFX 2.1

See Also:

getAlignment(), setAlignment(Pos)

setAlignment

public final void setAlignment(Pos value)

Sets the value of the property alignment.

Since:

JavaFX 2.1

getAlignment

public final Pos getAlignment()

Gets the value of the property alignment.

Since:

JavaFX 2.1

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.

getClassCssMetaData

public static java.util.List<<any>> getClassCssMetaData()

Returns:

The CssMetaData associated with this class, which may include the CssMetaData of its superclasses.

Since:

JavaFX 8.0

getControlCssMetaData

public java.util.List<<any>> getControlCssMetaData()

Overrides:

getControlCssMetaData in class TextInputControl

Returns:

unmodifiable list of the controls css styleable properties

Since:

JavaFX 8.0