javafx.scene.control

Class TextField

java.lang.Object

javafx.scene.Node

javafx.scene.Parent

javafx.scene.control.Control

javafx.scene.control.TextInputControl

javafx.scene.control.TextField

All Implemented Interfaces:

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

See Also:

TextArea

Property Summary

Properties

Type	Property and Description
ObjectProperty<EventHandler<ActionEvent>>	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.
StringProperty	promptText The TextField's prompt text to display, or null if no prompt text is displayed.

Properties inherited from class javafx.scene.control.TextInputControl

anchorProperty, caretPositionProperty, editableProperty, lengthProperty, selectedTextProperty, selectionProperty, textProperty

Properties inherited from class javafx.scene.control.Control

contextMenuProperty, heightProperty, maxHeightProperty, maxWidthProperty, minHeightProperty, minWidthProperty, prefHeightProperty, prefWidthProperty, skinProperty, tooltipProperty, widthProperty

Properties inherited from class javafx.scene.Parent

needsLayoutProperty

Properties inherited from class javafx.scene.Node

blendModeProperty, boundsInLocalProperty, boundsInParentProperty, cacheHintProperty, cacheProperty, clipProperty, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectProperty, eventDispatcherProperty, focusedProperty, focusTraversableProperty, hoverProperty, idProperty, inputMethodRequestsProperty, layoutBoundsProperty, layoutXProperty, layoutYProperty, managedProperty, mouseTransparentProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDraggedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onScrollProperty, opacityProperty, parentProperty, pickOnBoundsProperty, pressedProperty, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, styleProperty, translateXProperty, translateYProperty, translateZProperty, visibleProperty

Nested Class Summary

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

TextInputControl.Content

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_PREF_COLUMN_COUNT The default value for prefColumnCount.

Fields inherited from class javafx.scene.control.Control

USE_COMPUTED_SIZE, USE_PREF_SIZE

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

Methods

Modifier and Type	Method and Description
java.lang.CharSequence	getCharacters() Returns the character sequence backing the text field's content.
EventHandler<ActionEvent>	getOnAction() The action handler associated with this text field, or null if no action handler is assigned.
int	getPrefColumnCount() The preferred number of text columns.
java.lang.String	getPromptText() The TextField's prompt text to display, or null if no prompt text is displayed.
ObjectProperty<EventHandler<ActionEvent>>	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.
StringProperty	promptTextProperty() The TextField's prompt text to display, or null if no prompt text is displayed.
void	setOnAction(EventHandler<ActionEvent> value) The action handler associated with this text field, or null if no action handler is assigned.
void	setPrefColumnCount(int value) The preferred number of text columns.
void	setPromptText(java.lang.String value) The TextField's prompt text to display, or null if no prompt text is displayed.

Methods inherited from class javafx.scene.control.TextInputControl

anchorProperty, appendText, backward, caretPositionProperty, clear, copy, cut, deleteNextChar, deletePreviousChar, deleteText, deleteText, deselect, editableProperty, end, endOfNextWord, extendSelection, forward, getAnchor, getCaretPosition, getContent, getLength, getSelectedText, getSelection, getText, getText, home, insertText, isEditable, lengthProperty, nextWord, paste, positionCaret, previousWord, replaceSelection, replaceText, replaceText, selectAll, selectBackward, selectedTextProperty, selectEnd, selectEndOfNextWord, selectForward, selectHome, selectionProperty, selectNextWord, selectPositionCaret, selectPreviousWord, selectRange, setEditable, setText, textProperty

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, setTooltip, setWidth, skinProperty, tooltipProperty, widthProperty

Methods inherited from class javafx.scene.Parent

getChildren, getChildrenUnmodifiable, getManagedChildren, 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, getOnDragDetected, getOnDragDone, getOnDragDropped, getOnDragEntered, getOnDragExited, getOnDragOver, getOnInputMethodTextChanged, getOnKeyPressed, getOnKeyReleased, getOnKeyTyped, getOnMouseClicked, getOnMouseDragged, getOnMouseEntered, getOnMouseExited, getOnMouseMoved, getOnMousePressed, getOnMouseReleased, getOnScroll, 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, localToScene, localToScene, localToScene, lookupAll, managedProperty, mouseTransparentProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDraggedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onScrollProperty, 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, setOnDragDetected, setOnDragDone, setOnDragDropped, setOnDragEntered, setOnDragExited, setOnDragOver, setOnInputMethodTextChanged, setOnKeyPressed, setOnKeyReleased, setOnKeyTyped, setOnMouseClicked, setOnMouseDragged, setOnMouseEntered, setOnMouseExited, setOnMouseMoved, setOnMousePressed, setOnMouseReleased, setOnScroll, setOpacity, setPickOnBounds, setPressed, setRotate, setRotationAxis, setScaleX, setScaleY, setScaleZ, setStyle, setTranslateX, setTranslateY, setTranslateZ, setUserData, setVisible, startDragAndDrop, 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

promptText

The TextField's prompt text to display, or null if no prompt text is displayed.

See Also:

getPromptText(), setPromptText(String)

prefColumnCount

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

See Also:

getPrefColumnCount(), setPrefColumnCount(int)

onAction

The action handler associated with this text field, or null if no action handler is assigned.

See Also:

getOnAction(), setOnAction(EventHandler)

Field Detail

DEFAULT_PREF_COLUMN_COUNT

public static final int DEFAULT_PREF_COLUMN_COUNT

The default value for prefColumnCount.

See Also:

Constant Field Values

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.

promptTextProperty

public final StringProperty promptTextProperty()

The TextField's prompt text to display, or null if no prompt text is displayed.

See Also:

getPromptText(), setPromptText(String)

getPromptText

public final java.lang.String getPromptText()

The TextField's prompt text to display, or null if no prompt text is displayed.

setPromptText

public final void setPromptText(java.lang.String value)

The TextField's prompt text to display, or null if no prompt text is displayed.

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()

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

setPrefColumnCount

public final void setPrefColumnCount(int value)

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

onActionProperty

public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty()

The action handler associated with this text field, or null if no action handler is assigned.

See Also:

getOnAction(), setOnAction(EventHandler)

getOnAction

public final EventHandler<ActionEvent> getOnAction()

The action handler associated with this text field, or null if no action handler is assigned.

setOnAction

public final void setOnAction(EventHandler<ActionEvent> value)

The action handler associated with this text field, or null if no action handler is assigned.