Spec-Zone.ru › OpenJavaFX 17

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

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

Свойства
Тип Свойство Описание
IntegerProperty prefColumnCount
Предпочтительное количество столбцов текста.
IntegerProperty prefRowCount
Предпочтительное количество строк текста.
DoubleProperty scrollLeft
Количество пикселей горизонтальной прокрутки содержимого.
DoubleProperty scrollTop
Количество пикселей вертикальной прокрутки содержимого.
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, 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.
static 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()
List<CssMetaData<? extends Styleable,​?>> getControlCssMetaData()
ObservableList<CharSequence> getParagraphs()
Возвращает неизменяемый список последовательностей символов, которые представляют содержимое текстовой области.
int getPrefColumnCount()
Получает значение свойства prefColumnCount.
int getPrefRowCount()
Получает значение свойства prefRowCount.
double getScrollLeft()
Получает значение свойства scrollLeft.
double getScrollTop()
Получает значение свойства scrollTop.
boolean isWrapText()
Получает значение свойства wrapText.
IntegerProperty prefColumnCountProperty()
Предпочтительное количество текстовых столбцов.
IntegerProperty prefRowCountProperty()
Предпочтительное количество текстовых строк.
DoubleProperty scrollLeftProperty()
Количество пикселей горизонтального смещения содержимого.
DoubleProperty scrollTopProperty()
Количество пикселей вертикального смещения содержимого.
void setPrefColumnCount​(int value)
Устанавливает значение свойства prefColumnCount.
void setPrefRowCount​(int value)
Устанавливает значение свойства prefRowCount.
void setScrollLeft​(double value)
Устанавливает значение свойства scrollLeft.
void setScrollTop​(double value)
Устанавливает значение свойства scrollTop.
void setWrapText​(boolean value)
Устанавливает значение свойства wrapText.
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, 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

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

wrapText

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

prefColumnCount

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

prefRowCount

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

scrollTop

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

scrollLeft

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

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

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, то эта переменная указывает, нужно ли текст переносить на другую строку.
См. также:
isWrapText(), setWrapText(boolean)

isWrapText

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

setWrapText

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

prefColumnCountProperty

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

getPrefColumnCount

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

setPrefColumnCount

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

prefRowCountProperty

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

getPrefRowCount

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

setPrefRowCount

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

scrollTopProperty

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

getScrollTop

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

setScrollTop

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

scrollLeftProperty

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

getScrollLeft

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

setScrollLeft

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

getClassCssMetaData

public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()
Возвращает:
CssMetaData, связанная с этим классом, которая может включать CssMetaData его суперклассов.
С:
JavaFX 8.0

getControlCssMetaData

public List<CssMetaData<? extends Styleable,?>> getControlCssMetaData()
Переопределяет:
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