Spec-Zone.ru › OpenJavaFX 21

Класс TextArea

java.lang.Object
javafx.scene.Node
javafx.scene.Parent
javafx.scene.layout.Region
javafx.scene.control.Control
javafx.scene.control.TextInputControl
javafx.scene.control.TextArea
Все реализованные интерфейсы:
Styleable, EventTarget, Skinnable 
public class TextArea extends TextInputControl
Компонент ввода текста, который позволяет пользователю вводить несколько строк простого текста. В отличие от предыдущих релизов JavaFX, поддержка ввода одной строки недоступна как часть компонента TextArea, однако это единственное назначение компонента TextField. Кроме того, если вам нужна возможность редактирования форматированного текста, есть также компонент HTMLEditor.

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

Пример:

 var textArea = new TextArea("Lorem ipsum dolor sit amet, consectetur adipiscing elit, "
        + "sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim "
        + "ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip "
        + "ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate "
        + "velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat "
        + "cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.");
 textArea.setWrapText(true);
Image of the TextArea control
С:
JavaFX 2.0
См. также:
  • TextField

Сводка свойств

Тип Свойство Описание
final IntegerProperty prefColumnCount
Предпочтительное количество столбцов текста.
final IntegerProperty prefRowCount
Предпочтительное количество строк текста.
final DoubleProperty scrollLeft
Количество пикселей горизонтального скроллинга содержимого.
final DoubleProperty scrollTop
Количество пикселей вертикального скроллинга содержимого.
final BooleanProperty wrapText
Если строка текста превышает ширину TextArea, эта переменная указывает, нужно ли переносить текст на следующую строку.

Свойства, объявленные в классе 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.
static final int DEFAULT_PREF_ROW_COUNT
Значение по умолчанию для prefRowCount.

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

USE_COMPUTED_SIZE, USE_PREF_SIZE

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

BASELINE_OFFSET_SAME_AS_HEIGHT

Сводка конструкторов

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

Сводка методов

Модификатор и тип Метод Описание
static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()
Получает CssMetaData, связанное с этим классом, что может включать CssMetaData его суперклассов.
List<CssMetaData<? extends Styleable,?>> getControlCssMetaData()
Получает неизменяемый список свойств, стилизуемых CSS в элементе управления.
ObservableList<CharSequence> getParagraphs()
Возвращает неизменяемый список последовательностей символов, представляющих содержимое текстовой области.
final int getPrefColumnCount()
Получает значение свойства prefColumnCount.
final int getPrefRowCount()
Получает значение свойства prefRowCount.
final double getScrollLeft()
Получает значение свойства scrollLeft.
final double getScrollTop()
Получает значение свойства scrollTop.
final boolean isWrapText()
Получает значение свойства wrapText.
final IntegerProperty prefColumnCountProperty()
Предпочтительное количество столбцов текста.
final IntegerProperty prefRowCountProperty()
Предпочтительное количество строк текста.
final DoubleProperty scrollLeftProperty()
Количество пикселей горизонтального скроллинга содержимого.
final DoubleProperty scrollTopProperty()
Количество пикселей вертикального скроллинга содержимого.
final void setPrefColumnCount(int value)
Устанавливает значение свойства prefColumnCount.
final void setPrefRowCount(int value)
Устанавливает значение свойства prefRowCount.
final void setScrollLeft(double value)
Устанавливает значение свойства scrollLeft.
final void setScrollTop(double value)
Устанавливает значение свойства scrollTop.
final void setWrapText(boolean value)
Устанавливает значение свойства wrapText.
final BooleanProperty wrapTextProperty()
Если строка текста превышает ширину TextArea, эта переменная указывает, нужно ли переносить текст на следующую строку.

Методы, объявленные в классе 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

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

wrapText

public final BooleanProperty wrapTextProperty
Если строка текста превышает ширину TextArea, то эта переменная указывает, нужно ли переносить текст на новую строку.
См. также:
  • isWrapText()
  • setWrapText(boolean)
  • wrapTextProperty()

prefColumnCount

public final IntegerProperty prefColumnCountProperty
Предпочтительное количество столбцов текста. Используется для расчета предпочтительной ширины TextArea.
См. также:
  • getPrefColumnCount()
  • setPrefColumnCount(int)
  • prefColumnCountProperty()

prefRowCount

public final IntegerProperty prefRowCountProperty
Предпочтительное количество строк текста. Используется для расчета предпочтительной высоты TextArea.
См. также:
  • getPrefRowCount()
  • setPrefRowCount(int)
  • prefRowCountProperty()

scrollTop

public final DoubleProperty scrollTopProperty
Количество пикселей, на которое содержимое прокручено вертикально.
См. также:
  • getScrollTop()
  • setScrollTop(double)
  • scrollTopProperty()

scrollLeft

public final DoubleProperty scrollLeftProperty
Количество пикселей, на которое содержимое прокручено горизонтально.
См. также:
  • getScrollLeft()
  • setScrollLeft(double)
  • scrollLeftProperty()

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

DEFAULT_PREF_COLUMN_COUNT

public static final int DEFAULT_PREF_COLUMN_COUNT
Значение по умолчанию для prefColumnCount.
См. также:
  • Значения постоянных полей

DEFAULT_PREF_ROW_COUNT

public static final int DEFAULT_PREF_ROW_COUNT
Значение по умолчанию для prefRowCount.
См. также:
  • Значения постоянных полей

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

TextArea

public TextArea()
Создаёт TextArea с пустым текстовым содержимым.

TextArea

public TextArea(String text)
Создаёт TextArea с начальным текстовым содержимым.
Параметры:
text - Строка для текстового содержимого.

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

getParagraphs

public ObservableList<CharSequence> getParagraphs()
Возвращает список (неизменяемый) последовательностей символов, которые являются основой содержимого текстовой области.
Возвращает:
неизменяемый список последовательностей символов, которые являются основой содержимого текстовой области

wrapTextProperty

public final BooleanProperty wrapTextProperty()
Если строка текста превышает ширину TextArea, то эта переменная указывает, нужно ли переносить текст на новую строку.
Возвращает:
свойство wrapText
См. также:
  • isWrapText()
  • setWrapText(boolean)

isWrapText

public final boolean isWrapText()
Получает значение свойства wrapText.
Описание свойства:
Если строка текста превышает ширину TextArea, то эта переменная указывает, нужно ли переносить текст на новую строку.
Возвращает:
значение свойства wrapText
См. также:
  • setWrapText(boolean)
  • wrapTextProperty()

setWrapText

public final void setWrapText(boolean value)
Устанавливает значение свойства wrapText.
Описание свойства:
Если строка текста превышает ширину TextArea, то эта переменная указывает, нужно ли переносить текст на новую строку.
Параметры:
value - значение для свойства wrapText
См. также:
  • isWrapText()
  • wrapTextProperty()

prefColumnCountProperty

public final IntegerProperty prefColumnCountProperty()
Предпочтительное количество столбцов текста. Используется для расчета предпочтительной ширины TextArea.
Возвращает:
свойство prefColumnCount
См. также:
  • getPrefColumnCount()
  • setPrefColumnCount(int)

getPrefColumnCount

public final int getPrefColumnCount()
Получает значение свойства prefColumnCount.
Описание свойства:
Предпочтительное количество столбцов текста. Используется для расчета предпочтительной ширины TextArea.
Возвращает:
значение свойства prefColumnCount
См. также:
  • setPrefColumnCount(int)
  • prefColumnCountProperty()

setPrefColumnCount

public final void setPrefColumnCount(int value)
Устанавливает значение свойства prefColumnCount.
Описание свойства:
Предпочтительное количество столбцов текста. Используется для расчета предпочтительной ширины TextArea.
Параметры:
value - значение для свойства prefColumnCount
См. также:
  • getPrefColumnCount()
  • prefColumnCountProperty()

prefRowCountProperty

public final IntegerProperty prefRowCountProperty()
Предпочтительное количество строк текста. Используется для расчета предпочтительной высоты TextArea.
Возвращает:
свойство prefRowCount
См. также:
  • getPrefRowCount()
  • setPrefRowCount(int)

getPrefRowCount

public final int getPrefRowCount()
Получает значение свойства prefRowCount.
Описание свойства:
Предпочтительное количество строк текста. Используется для расчета предпочтительной высоты TextArea.
Возвращает:
значение свойства prefRowCount
См. также:
  • setPrefRowCount(int)
  • prefRowCountProperty()

setPrefRowCount

public final void setPrefRowCount(int value)
Устанавливает значение свойства prefRowCount.
Описание свойства:
Предпочтительное количество строк текста. Используется для расчета предпочтительной высоты TextArea.
Параметры:
value - значение для свойства prefRowCount
См. также:
  • getPrefRowCount()
  • prefRowCountProperty()

scrollTopProperty

public final DoubleProperty scrollTopProperty()
Количество пикселей, на которое содержимое прокручено вертикально.
Возвращает:
свойство scrollTop
См. также:
  • getScrollTop()
  • setScrollTop(double)

getScrollTop

public final double getScrollTop()
Получает значение свойства scrollTop.
Описание свойства:
Количество пикселей, на которое содержимое прокручено вертикально.
Возвращает:
значение свойства scrollTop
См. также:
  • setScrollTop(double)
  • scrollTopProperty()

setScrollTop

public final void setScrollTop(double value)
Устанавливает значение свойства scrollTop.
Описание свойства:
Количество пикселей, на которое содержимое прокручено вертикально.
Параметры:
value - значение для свойства scrollTop
См. также:
  • getScrollTop()
  • scrollTopProperty()

scrollLeftProperty

public final DoubleProperty scrollLeftProperty()
Количество пикселей, на которое содержимое прокручено горизонтально.
Возвращает:
свойство scrollLeft
См. также:
  • getScrollLeft()
  • setScrollLeft(double)

getScrollLeft

public final double getScrollLeft()
Возвращает значение свойства scrollLeft.
Описание свойства:
Количество пикселей, на которое содержимое прокручено горизонтально.
Возвращает:
значение свойства scrollLeft
См. также:
  • setScrollLeft(double)
  • scrollLeftProperty()

setScrollLeft

public final void setScrollLeft(double value)
Устанавливает значение свойства scrollLeft.
Описание свойства:
Количество пикселей, на которое содержимое прокручено горизонтально.
Параметры:
value - значение для свойства scrollLeft
См. также:
  • getScrollLeft()
  • scrollLeftProperty()

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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API