- 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
-
- All Implemented Interfaces:
-
Styleable
,EventTarget
,Skinnable
public class TextArea extends TextInputControl
文本输入组件,允许用户输入多行纯文本。 与以前的JavaFX版本不同,对单行输入的支持不能作为TextArea控件的一部分提供,但这是TextField
控件的唯一目的。 另外,如果你想要一个富文本编辑的形式,还有HTMLEditor
控件。当TextArea中没有
text
(通过用户或以编程方式设置))时,TextArea支持向用户显示prompt text
的概念。 这是向用户通知文本区域中预期的内容的有用方式,而无需诉诸tooltips
或屏幕上的labels
。- 从以下版本开始:
- JavaFX 2.0
- 另请参见:
-
TextField
-
-
Property Summary
Properties Type Property 描述 IntegerProperty
prefColumnCount
文本列的首选数量。IntegerProperty
prefRowCount
文本行的首选数量。DoubleProperty
scrollLeft
内容水平滚动的像素数。DoubleProperty
scrollTop
垂直滚动内容的像素数。BooleanProperty
wrapText
如果文本的运行超出了TextArea
的宽度,则该变量指示文本是否应该TextArea
另一行。-
Properties inherited from class javafx.scene.control.Control
contextMenu, skin, tooltip
-
Properties inherited from class 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
-
Properties inherited from class javafx.scene.Parent
needsLayout
-
Properties inherited from class javafx.scene.layout.Region
background, border, cacheShape, centerShape, height, insets, maxHeight, maxWidth, minHeight, minWidth, opaqueInsets, padding, prefHeight, prefWidth, scaleShape, shape, snapToPixel, width
-
Properties inherited from class javafx.scene.control.TextInputControl
anchor, caretPosition, editable, font, length, promptText, redoable, selectedText, selection, textFormatter, text, undoable
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class javafx.scene.control.TextInputControl
TextInputControl.Content
-
-
Field Summary
Fields Modifier and Type Field 描述 static int
DEFAULT_PREF_COLUMN_COUNT
默认值为prefColumnCount
。static int
DEFAULT_PREF_ROW_COUNT
默认值为prefRowCount
。-
Fields inherited from class javafx.scene.Node
BASELINE_OFFSET_SAME_AS_HEIGHT
-
Fields inherited from class javafx.scene.layout.Region
USE_COMPUTED_SIZE, USE_PREF_SIZE
-
-
方法摘要
所有方法 静态方法 接口方法 具体的方法 Modifier and Type 方法 描述 protected Skin<?>
createDefaultSkin()
为此控件创建一个新的默认皮肤实例。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()
获取propertyTextText的值。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
的宽度,则该变量指示文本是否应该TextArea
另一行。-
Methods inherited from class javafx.scene.control.Control
computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, contextMenuProperty, getBaselineOffset, getContextMenu, getCssMetaData, getInitialFocusTraversable, getSkin, getTooltip, isResizable, layoutChildren, setContextMenu, setSkin, setTooltip, skinProperty, tooltipProperty
-
Methods inherited from class 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, 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, getStyleClass, 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, 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, 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
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from class javafx.scene.Parent
getChildren, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, lookup, needsLayoutProperty, requestLayout, requestParentLayout, setNeedsLayout, updateBounds
-
Methods inherited from class javafx.scene.layout.Region
backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, 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
-
Methods inherited from interface javafx.css.Styleable
getStyleableNode
-
Methods inherited from class javafx.scene.control.TextInputControl
anchorProperty, appendText, backward, cancelEdit, caretPositionProperty, clear, commitValue, copy, cut, deleteNextChar, deletePreviousChar, deleteText, deleteText, deselect, editableProperty, end, endOfNextWord, executeAccessibleAction, 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, queryAccessibleAttribute, 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
-
-
-
-
Property Detail
-
wrapText
public final BooleanProperty wrapTextProperty
如果文本的运行超出了TextArea
的宽度,则该变量指示文本是否应该TextArea
另一行。- 另请参见:
-
isWrapText()
,setWrapText(boolean)
-
prefColumnCount
public final IntegerProperty prefColumnCountProperty
文本列的首选数量。 这用于计算TextArea
的首选宽度。
-
prefRowCount
public final IntegerProperty prefRowCountProperty
文本行的首选数量。 这用于计算TextArea
的首选高度。
-
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
。- 另请参见:
- Constant Field Values
-
DEFAULT_PREF_ROW_COUNT
public static final int DEFAULT_PREF_ROW_COUNT
默认值为prefRowCount
。- 另请参见:
- Constant Field Values
-
-
构造方法详细信息
-
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()
获取propertyTextText的值。- Property description:
-
如果文本的运行超出了
TextArea
的宽度,则该变量指示文本是否应该TextArea
另一行。
-
setWrapText
public final void setWrapText(boolean value)
设置属性wrapText的值。- Property description:
-
如果文本的运行超出了
TextArea
的宽度,则该变量指示文本是否应该TextArea
另一行。
-
prefColumnCountProperty
public final IntegerProperty prefColumnCountProperty()
文本列的首选数量。 这用于计算TextArea
的首选宽度。
-
getPrefColumnCount
public final int getPrefColumnCount()
获取属性prefColumnCount的值。- Property description:
-
文本列的首选数量。
这用于计算
TextArea
的首选宽度。
-
setPrefColumnCount
public final void setPrefColumnCount(int value)
设置属性prefColumnCount的值。- Property description:
-
文本列的首选数量。
这用于计算
TextArea
的首选宽度。
-
prefRowCountProperty
public final IntegerProperty prefRowCountProperty()
文本行的首选数量。 这用于计算TextArea
的首选高度。
-
getPrefRowCount
public final int getPrefRowCount()
获取属性prefRowCount的值。- Property description:
-
文本行的首选数量。
这用于计算
TextArea
的首选高度。
-
setPrefRowCount
public final void setPrefRowCount(int value)
设置属性prefRowCount的值。- Property description:
-
文本行的首选数量。
这用于计算
TextArea
的首选高度。
-
scrollTopProperty
public final DoubleProperty scrollTopProperty()
垂直滚动内容的像素数。- 另请参见:
-
getScrollTop()
,setScrollTop(double)
-
getScrollTop
public final double getScrollTop()
获取属性scrollTop的值。- Property description:
- 垂直滚动内容的像素数。
-
setScrollTop
public final void setScrollTop(double value)
设置属性scrollTop的值。- Property description:
- 垂直滚动内容的像素数。
-
scrollLeftProperty
public final DoubleProperty scrollLeftProperty()
内容水平滚动的像素数。- 另请参见:
-
getScrollLeft()
,setScrollLeft(double)
-
getScrollLeft
public final double getScrollLeft()
获取属性scrollLeft的值。- Property description:
- 内容水平滚动的像素数。
-
setScrollLeft
public final void setScrollLeft(double value)
设置属性scrollLeft的值。- Property description:
- 内容水平滚动的像素数。
-
createDefaultSkin
protected Skin<?> createDefaultSkin()
为此控件创建一个新的默认皮肤实例。 如果没有通过CSS-fx-skin
提供皮肤,或者在具有setSkin(...)
的子类中显式设置,则调用此控件创建皮肤。- 重写:
-
createDefaultSkin
在Control
- 结果
- 此控件的默认皮肤的新实例。 如果为null,则控件将没有皮肤,除非由css提供。
-
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
-
-