Класс 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

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

Тип	Свойство	Описание
`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

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

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

TextInputControl.Content

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

Модификатор и тип	Поле	Описание
`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, 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.

См. также:

getPrefColumnCount()
setPrefColumnCount(int)
prefColumnCountProperty()

onAction

public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty

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

См. также:

getOnAction()
setOnAction(EventHandler)
onActionProperty()

alignment

public final ObjectProperty<Pos> alignmentProperty

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

С:

JavaFX 2.1

См. также:

getAlignment()
setAlignment(Pos)
alignmentProperty()

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

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

getPrefColumnCount

public final int getPrefColumnCount()

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

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

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

Возвращает:

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

См. также:

setPrefColumnCount(int)
prefColumnCountProperty()

setPrefColumnCount

public final void setPrefColumnCount(int value)

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

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

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

Параметры:

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

См. также:

getPrefColumnCount()
prefColumnCountProperty()

onActionProperty

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

Возвращает:

свойство onAction

См. также:

getOnAction()
setOnAction(EventHandler)

getOnAction

public final EventHandler<ActionEvent> getOnAction()

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

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

Возвращает:

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

См. также:

setOnAction(EventHandler)
onActionProperty()

setOnAction

public final void setOnAction(EventHandler<ActionEvent> value)

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

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

Параметры:

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

См. также:

getOnAction()
onActionProperty()

alignmentProperty

public final ObjectProperty<Pos> alignmentProperty()

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

Возвращает:

свойство выравнивания

С:

JavaFX 2.1

См. также:

getAlignment()
setAlignment(Pos)

setAlignment

public final void setAlignment(Pos value)

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

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

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

Параметры:

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

С:

JavaFX 2.1

См. также:

getAlignment()
alignmentProperty()

getAlignment

public final Pos getAlignment()

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

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

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

Возвращает:

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

С:

JavaFX 2.1

См. также:

setAlignment(Pos)
alignmentProperty()

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.