Класс TextField

javafx.scene.control.TextField

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

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

public class TextField
extends TextInputControl

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

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

Пример:

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

С:: JavaFX 2.0
См. также:: TextArea

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

Свойства
Тип	Свойство	Описание
`ObjectProperty<Pos>`	`alignment`	Указывает, как текст должен выравниваться при наличии свободного места в поле ввода.
`ObjectProperty<EventHandler<ActionEvent>>`	`onAction`	Обработчик действия, связанный с этим текстовым полем, или `null`, если обработчик действия не назначен.
`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, 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

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

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

TextInputControl.Content

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

Поля
Модификатор и тип	Поле	Описание
`static 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` с начальным содержимым текста.

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

Модификатор и тип	Метод	Описание
`ObjectProperty<Pos>`	`alignmentProperty()`	Указывает, как текст должен выравниваться при наличии свободного места в поле ввода.
`Pos`	`getAlignment()`	Получает значение свойства выравнивания.
`CharSequence`	`getCharacters()`	Возвращает последовательность символов, лежащую в основе содержимого текстового поля.
`static List<CssMetaData<? extends Styleable,?>>`	`getClassCssMetaData()`
`List<CssMetaData<? extends Styleable,?>>`	`getControlCssMetaData()`
`EventHandler<ActionEvent>`	`getOnAction()`	Получает значение свойства onAction.
`int`	`getPrefColumnCount()`	Получает значение свойства prefColumnCount.
`ObjectProperty<EventHandler<ActionEvent>>`	`onActionProperty()`	Обработчик действия, связанный с этим текстовым полем, или `null`, если обработчик действия не назначен.
`IntegerProperty`	`prefColumnCountProperty()`	Предпочтительное количество столбцов текста.
`void`	`setAlignment(Pos value)`	Устанавливает значение свойства выравнивания.
`void`	`setOnAction(EventHandler<ActionEvent> value)`	Устанавливает значение свойства onAction.
`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, getTooltip, isResizable, setContextMenu, 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, 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, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, getViewOrder, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, 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, 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.scene.control.Skinnable

getSkin, setSkin

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

getStyleableNode, getStyleClass

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

prefColumnCount

public final IntegerProperty prefColumnCountProperty

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

См. также:: getPrefColumnCount(), setPrefColumnCount(int)

onAction

public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty

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

См. также:: getOnAction(), setOnAction(EventHandler)

alignment

public final ObjectProperty<Pos> alignmentProperty

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

С:: JavaFX 2.1
См. также:: getAlignment(), setAlignment(Pos)

Подробное описание полей

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

См. также:: getPrefColumnCount(), setPrefColumnCount(int)

getPrefColumnCount

public final int getPrefColumnCount()

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

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

setPrefColumnCount

public final void setPrefColumnCount(int value)

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

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

onActionProperty

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

См. также:: getOnAction(), setOnAction(EventHandler)

getOnAction

public final EventHandler<ActionEvent> getOnAction()

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

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

setOnAction

public final void setOnAction(EventHandler<ActionEvent> value)

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

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

alignmentProperty

public final ObjectProperty<Pos> alignmentProperty()

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

С:: JavaFX 2.1
См. также:: getAlignment(), setAlignment(Pos)

setAlignment

public final void setAlignment(Pos value)

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

Описание свойства:: Определяет, как должен выравниваться текст, когда в текстовом поле есть свободное место.
С:: JavaFX 2.1

getAlignment

public final Pos getAlignment()

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

Описание свойства:: Определяет, как должен выравниваться текст, когда в текстовом поле есть свободное место.
С:: JavaFX 2.1

getClassCssMetaData

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

Возвращает:: CssMetaData, связанный с этим классом, который может включать CssMetaData его суперклассов.
С:: JavaFX 8.0

getControlCssMetaData

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

Переопределяет:: getControlCssMetaData в классе TextInputControl
Возвращает:: неизменяемый список стилевых свойств элементов управления
С:: 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.