Класс TextField

javafx.scene.control.TextField

Все реализуемые интерфейсы:: Styleable, EventTarget, Skinnable

Прямые известные подклассы:: PasswordField

public class TextField extends TextInputControl

Компонент ввода текста, который позволяет пользователю вводить одну строку неформатированного текста. В отличие от предыдущих релизов JavaFX, поддержка многострочного ввода недоступна в качестве части компонента TextField, однако это единственная цель компонента TextArea. Кроме того, если вам нужен редактор форматированного текста, также есть компонент HTMLEditor.

TextField поддерживает показ подсказки prompt text пользователю, когда в TextField еще нет текста (ни со стороны пользователя, ни установленного программно). Это полезный способ проинформировать пользователя о том, что ожидается в поле ввода, не прибегая к tooltips или экранной labels.

Пример:

 var textField = new TextField("Hello World!");

С:

JavaFX 2.0

См. также:

Краткое описание вложенных классов

Вложенные классы/интерфейсы, объявленные в классе javafx.scene.control.TextInputControl

TextInputControl.Content

Краткое описание свойств

Тип	Свойство	Описание
`final ObjectProperty<Pos>`	`alignment`	Определяет, как текст должен выравниваться при наличии пустого места в TextField.
`final ObjectProperty<EventHandler<ActionEvent>>`	`onAction`	Обработчик действия, связанный с этим полем ввода, или `null`, если обработчик действия не назначен.
`final IntegerProperty`	`prefColumnCount`	Предпочтительное количество столбцов текста.

Свойства, объявленные в классе javafx.scene.control.TextInputControl

anchor, caretPosition, editable, font, length, promptText, redoable, selectedText, selection, textFormatter, text, undoable

Свойства, объявленные в классе javafx.scene.control.Control

contextMenu, skin, tooltip

Свойства, объявленные в классе javafx.scene.layout.Region

background, border, cacheShape, centerShape, height, insets, maxHeight, maxWidth, minHeight, minWidth, opaqueInsets, padding, prefHeight, prefWidth, scaleShape, shape, snapToPixel, width

Свойства, объявленные в классе javafx.scene.Parent

needsLayout

Свойства, объявленные в классе javafx.scene.Node

accessibleHelp, accessibleRoleDescription, accessibleRole, accessibleText, blendMode, boundsInLocal, boundsInParent, cacheHint, cache, clip, cursor, depthTest, disabled, disable, effectiveNodeOrientation, effect, eventDispatcher, focused, focusTraversable, focusVisible, focusWithin, hover, id, inputMethodRequests, layoutBounds, layoutX, layoutY, localToParentTransform, localToSceneTransform, managed, mouseTransparent, nodeOrientation, 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, viewOrder, visible

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final int`	`DEFAULT_PREF_COLUMN_COUNT`	Значение по умолчанию для `prefColumnCount`.

Поля, объявленные в классе javafx.scene.layout.Region

USE_COMPUTED_SIZE, USE_PREF_SIZE

Поля, объявленные в классе javafx.scene.Node

BASELINE_OFFSET_SAME_AS_HEIGHT

Краткое описание конструкторов

Конструктор	Описание
`TextField()`	Создаёт `TextField` с пустым содержимым текста.
`TextField(String text)`	Создаёт `TextField` с начальным содержимым текста.

Краткое описание методов

Модификатор и тип	Метод	Описание
`final ObjectProperty<Pos>`	`alignmentProperty()`	Определяет, как текст должен выравниваться при наличии пустого места в TextField.
`final Pos`	`getAlignment()`	Получает значение свойства `alignment`.
`CharSequence`	`getCharacters()`	Возвращает последовательность символов, лежащую в основе содержимого поля ввода.
`static List<CssMetaData<? extends Styleable,?>>`	`getClassCssMetaData()`	Возвращает ассоциированный с этим классом `CssMetaData`, который может включать `CssMetaData` своих суперклассов.
`List<CssMetaData<? extends Styleable,?>>`	`getControlCssMetaData()`	Возвращает неизменяемый список стилизуемых CSS свойств компонента.
`final EventHandler<ActionEvent>`	`getOnAction()`	Получает значение свойства `onAction`.
`final int`	`getPrefColumnCount()`	Получает значение свойства `prefColumnCount`.
`final ObjectProperty<EventHandler<ActionEvent>>`	`onActionProperty()`	Обработчик действия, связанный с этим полем ввода, или `null`, если обработчик действия не назначен.
`final IntegerProperty`	`prefColumnCountProperty()`	Предпочтительное количество столбцов текста.
`final void`	`setAlignment(Pos value)`	Устанавливает значение свойства `alignment`.
`final void`	`setOnAction(EventHandler<ActionEvent> value)`	Устанавливает значение свойства `onAction`.
`final void`	`setPrefColumnCount(int value)`	Устанавливает значение свойства `prefColumnCount`.

Методы, объявленные в классе javafx.scene.control.TextInputControl

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

Методы, объявленные в классе javafx.scene.control.Control

computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, contextMenuProperty, createDefaultSkin, getContextMenu, getCssMetaData, getInitialFocusTraversable, getSkin, getTooltip, isResizable, setContextMenu, setSkin, setTooltip, skinProperty, tooltipProperty

Методы, объявленные в классе javafx.scene.layout.Region

backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, computePrefHeight, computePrefWidth, getBackground, getBorder, getHeight, getInsets, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getOpaqueInsets, getPadding, getPrefHeight, getPrefWidth, getShape, getUserAgentStylesheet, getWidth, heightProperty, insetsProperty, isCacheShape, isCenterShape, isScaleShape, isSnapToPixel, layoutInArea, layoutInArea, layoutInArea, layoutInArea, maxHeight, maxHeightProperty, maxWidth, maxWidthProperty, minHeight, minHeightProperty, minWidth, minWidthProperty, opaqueInsetsProperty, paddingProperty, positionInArea, positionInArea, prefHeight, prefHeightProperty, prefWidth, prefWidthProperty, resize, scaleShapeProperty, setBackground, setBorder, setCacheShape, setCenterShape, setHeight, setMaxHeight, setMaxSize, setMaxWidth, setMinHeight, setMinSize, setMinWidth, setOpaqueInsets, setPadding, setPrefHeight, setPrefSize, setPrefWidth, setScaleShape, setShape, setSnapToPixel, setWidth, shapeProperty, snappedBottomInset, snappedLeftInset, snappedRightInset, snappedTopInset, snapPosition, snapPositionX, snapPositionY, snapSize, snapSizeX, snapSizeY, snapSpace, snapSpaceX, snapSpaceY, snapToPixelProperty, widthProperty

Методы, объявленные в классе javafx.scene.Parent

getBaselineOffset, getChildren, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, layoutChildren, needsLayoutProperty, requestLayout, requestParentLayout, setNeedsLayout, updateBounds

Методы, объявленные в классе javafx.scene.Node

accessibleHelpProperty, accessibleRoleDescriptionProperty, accessibleRoleProperty, accessibleTextProperty, addEventFilter, addEventHandler, applyCss, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, computeAreaInScreen, contains, contains, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectiveNodeOrientationProperty, effectProperty, eventDispatcherProperty, executeAccessibleAction, fireEvent, focusedProperty, focusTraversableProperty, focusVisibleProperty, focusWithinProperty, getAccessibleHelp, getAccessibleRole, getAccessibleRoleDescription, getAccessibleText, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClip, getContentBias, getCursor, getDepthTest, getEffect, getEffectiveNodeOrientation, getEventDispatcher, getId, getInitialCursor, getInputMethodRequests, getLayoutBounds, getLayoutX, getLayoutY, getLocalToParentTransform, getLocalToSceneTransform, getNodeOrientation, 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, getPseudoClassStates, getRotate, getRotationAxis, getScaleX, getScaleY, getScaleZ, getScene, getStyle, getStyleableParent, getStyleClass, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, getViewOrder, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isFocusVisible, isFocusWithin, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, isVisible, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParent, localToParent, localToParent, localToParent, localToParent, localToParentTransformProperty, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToSceneTransformProperty, localToScreen, localToScreen, localToScreen, localToScreen, localToScreen, lookup, lookupAll, managedProperty, mouseTransparentProperty, nodeOrientationProperty, notifyAccessibleAttributeChanged, 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, parentToLocal, parentToLocal, pickOnBoundsProperty, pressedProperty, pseudoClassStateChanged, queryAccessibleAttribute, relocate, removeEventFilter, removeEventHandler, requestFocus, requestFocusTraversal, resizeRelocate, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, screenToLocal, screenToLocal, screenToLocal, setAccessibleHelp, setAccessibleRole, setAccessibleRoleDescription, setAccessibleText, setBlendMode, setCache, setCacheHint, setClip, setCursor, setDepthTest, setDisable, setDisabled, setEffect, setEventDispatcher, setEventHandler, setFocused, setFocusTraversable, setHover, setId, setInputMethodRequests, setLayoutX, setLayoutY, setManaged, setMouseTransparent, setNodeOrientation, 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, setViewOrder, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, usesMirroring, viewOrderProperty, visibleProperty

Методы, объявленные в классе java.lang.Object

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

Методы, объявленные в интерфейсе javafx.css.Styleable

getStyleableNode

Подробности свойства

prefColumnCount

public final IntegerProperty prefColumnCountProperty

Предпочтительное количество столбцов текста. Это используется для расчета предпочтительной ширины TextField.

См. также:

onAction

public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty

Обработчик действия, связанный с этим текстовым полем, или null, если обработчик действия не назначен. Обработчик действия обычно вызывается, когда пользователь нажимает клавишу ENTER.

См. также:

alignment

public final ObjectProperty<Pos> alignmentProperty

Указывает, как должен выравниваться текст, когда в поле TextField есть свободное место.

С момента:

JavaFX 2.1

См. также:

Подробности поля

DEFAULT_PREF_COLUMN_COUNT

public static final int DEFAULT_PREF_COLUMN_COUNT

Значение по умолчанию для prefColumnCount.

См. также:

Подробности конструктора

TextField

public TextField()

Создает TextField с пустым текстовым содержимым.

TextField

public TextField(String text)

Создает TextField с начальным текстовым содержимым.

Параметры:: text - Строка для текстового содержимого.

Подробности метода

getCharacters

public CharSequence getCharacters()

Возвращает последовательность символов, которая служит основой для содержимого текстового поля.

Возвращает:: Последовательность символов, которая служит основой для содержимого текстового поля.

prefColumnCountProperty

public final IntegerProperty prefColumnCountProperty()

Предпочтительное количество столбцов текста. Это используется для расчета предпочтительной ширины TextField.

Возвращает:

Свойство prefColumnCount

См. также:

getPrefColumnCount

public final int getPrefColumnCount()

Получает значение свойства prefColumnCount.

Описание свойства:

Предпочтительное количество столбцов текста. Это используется для расчета предпочтительной ширины TextField.

Возвращает:

Значение свойства prefColumnCount

См. также:

setPrefColumnCount

public final void setPrefColumnCount(int value)

Устанавливает значение свойства prefColumnCount.

Описание свойства:

Предпочтительное количество столбцов текста. Это используется для расчета предпочтительной ширины TextField.

Параметры:

value - значение для свойства prefColumnCount

См. также:

onActionProperty

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

Возвращает:

свойство onAction

См. также:

getOnAction

public final EventHandler<ActionEvent> getOnAction()

Получает значение свойства onAction.

Описание свойства:

Возвращает:

значение свойства onAction

См. также:

setOnAction

public final void setOnAction(EventHandler<ActionEvent> value)

Устанавливает значение свойства onAction.

Описание свойства:

Параметры:

value - значение для свойства onAction

См. также:

alignmentProperty

public final ObjectProperty<Pos> alignmentProperty()

Указывает, как должен выравниваться текст, когда в поле TextField есть свободное место.

Возвращает:

свойство alignment

С момента:

JavaFX 2.1

См. также:

setAlignment

public final void setAlignment(Pos value)

Устанавливает значение свойства alignment.

Описание свойства:

Указывает, как должен выравниваться текст, когда в поле TextField есть свободное место.

Параметры:

value - значение для свойства alignment

С момента:

JavaFX 2.1

См. также:

getAlignment

public final Pos getAlignment()

Получает значение свойства alignment.

Описание свойства:

Указывает, как должен выравниваться текст, когда в поле TextField есть свободное место.

Возвращает:

значение свойства alignment

С момента:

JavaFX 2.1

См. также:

getClassCssMetaData

public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()

Получает CssMetaData, связанное с этим классом, который может включать в себя CssMetaData его суперклассов.

Возвращает:: CssMetaData
С момента:: JavaFX 8.0

getControlCssMetaData

public List<CssMetaData<? extends Styleable,?>> getControlCssMetaData()

Получает неизменяемый список CSS-стилизуемых свойств управления.

Переопределяет:: getControlCssMetaData в классе TextInputControl
Возвращает:: неизменяемый список CSS-стилизуемых свойств управления
С момента:: JavaFX 8.0

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.