Class TextAreaSkin

java.lang.Object

javafx.scene.control.SkinBase<TextArea>

javafx.scene.control.skin.TextInputControlSkin<TextArea>

javafx.scene.control.skin.TextAreaSkin

All Implemented Interfaces:

Skin<TextArea>

public class TextAreaSkin
extends TextInputControlSkin<TextArea>

Default skin implementation for the TextArea control.

Since:

9

See Also:

• TextArea

Nested Class Summary

Nested classes/interfaces declared in class TextInputControlSkin

TextInputControlSkin.Direction, TextInputControlSkin.TextUnit

Modifier and Type	Class	Description
static enum	TextInputControlSkin.Direction	Direction names for caret movement.
static enum	TextInputControlSkin.TextUnit	Unit names for caret movement.

Property Summary

Properties declared in class TextInputControlSkin

forwardBias, highlightFill, highlightTextFill, promptTextFill, textFill

Type	Property	Description
protected final BooleanProperty	forwardBias	Caret bias in the content.
protected final ObjectProperty<Paint>	highlightFill	The fill to use for the text when highlighted.
protected final ObjectProperty<Paint>	highlightTextFill	The fill Paint used for the foreground of selected text.
protected final ObjectProperty<Paint>	promptTextFill	The fill Paint used for the foreground of prompt text.
protected final ObjectProperty<Paint>	textFill	The fill to use for the text under normal conditions

Constructor Summary

Constructors

Constructor	Description
TextAreaSkin(TextArea control)	Creates a new TextAreaSkin instance, installing the necessary child nodes into the Control children list, as well as the necessary input mappings for handling key, mouse, etc events.

Method Summary

Modifier and Type	Method	Description
protected void	addHighlight(List<? extends Node> nodes, int start)	Adds highlight for composed text from Input Method.
double	computeBaselineOffset(double topInset, double rightInset, double bottomInset, double leftInset)	Calculates the baseline offset based on the first managed child.
Bounds	getCaretBounds()	Gets the Bounds of the caret of the skinned TextArea.
HitInfo	getIndex(double x, double y)	Performs a hit test, mapping point to index in the content.
protected PathElement[]	getRangeShape(int start, int end)	Gets the path elements describing the bounding rectangles for the given range of text.
protected PathElement[]	getUnderlineShape(int start, int end)	Gets the path elements describing the shape of the underline for the given range.
void	moveCaret(TextInputControlSkin.TextUnit unit, TextInputControlSkin.Direction dir, boolean select)	Moves the caret by one of the given text unit, in the given direction.
void	positionCaret(HitInfo hit, boolean select)	Moves the caret to the specified position.
protected void	removeHighlight(List<? extends Node> nodes)	Removes highlight for composed text from Input Method.

Methods declared in class TextInputControlSkin

forwardBiasProperty, getCharacterBounds, getClassCssMetaData, getHighlightFill, getHighlightTextFill, getInsertionPoint, getMenuPosition, getPromptTextFill, getTextFill, handleInputMethodEvent, highlightFillProperty, highlightTextFillProperty, invalidateMetrics, isForwardBias, maskText, promptTextFillProperty, scrollCharacterToVisible, setCaretAnimating, setForwardBias, setHighlightFill, setHighlightTextFill, setPromptTextFill, setTextFill, textFillProperty, updateHighlightFill, updateHighlightTextFill, updateTextFill

Modifier and Type	Method	Description
protected final BooleanProperty	forwardBiasProperty()	Caret bias in the content.
Rectangle2D	getCharacterBounds(int index)	Returns the bounds of the character at a given index.
static List<CssMetaData<? extends Styleable, ?>>	getClassCssMetaData()	Returns the CssMetaData associated with this class, which may include the CssMetaData of its superclasses.
protected final Paint	getHighlightFill()	Gets the value of the highlightFill property.
protected final Paint	getHighlightTextFill()	Gets the value of the highlightTextFill property.
protected int	getInsertionPoint(double x, double y)	Returns the insertion point for a given location.
Point2D	getMenuPosition()	Returns the position to be used for a context menu, based on the location of the caret handle or selection handles.
protected final Paint	getPromptTextFill()	Gets the value of the promptTextFill property.
protected final Paint	getTextFill()	Gets the value of the textFill property.
protected void	handleInputMethodEvent(InputMethodEvent event)	Handles an input method event.
protected final ObjectProperty<Paint>	highlightFillProperty()	The fill to use for the text when highlighted.
protected final ObjectProperty<Paint>	highlightTextFillProperty()	The fill Paint used for the foreground of selected text.
protected void	invalidateMetrics()	Invalidates cached min and pref sizes for the TextInputControl.
protected final boolean	isForwardBias()	Gets the value of the forwardBias property.
protected String	maskText(String txt)	This method may be overridden by subclasses to replace the displayed characters without affecting the actual text content.
protected final ObjectProperty<Paint>	promptTextFillProperty()	The fill Paint used for the foreground of prompt text.
protected void	scrollCharacterToVisible(int index)	Ensures that the character at a given index is visible.
void	setCaretAnimating(boolean value)	Starts or stops caret blinking.
final void	setForwardBias(boolean isLeading)	Sets the value of the forwardBias property.
protected final void	setHighlightFill(Paint value)	The fill Paint used for the background of selected text.
protected final void	setHighlightTextFill(Paint value)	The fill Paint used for the foreground of selected text.
protected final void	setPromptTextFill(Paint value)	The fill Paint used for the foreground prompt text color.
protected final void	setTextFill(Paint value)	The fill Paint used for the foreground text color.
protected final ObjectProperty<Paint>	textFillProperty()	The fill to use for the text under normal conditions
protected void	updateHighlightFill()	Called when highlightFill property changes.
protected void	updateHighlightTextFill()	Called when highlightTextFill property changes.
protected void	updateTextFill()	Called when textFill property changes.

Methods declared in class SkinBase

computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, consumeMouseEvents, dispose, executeAccessibleAction, getChildren, getCssMetaData, getNode, getSkinnable, layoutChildren, layoutInArea, layoutInArea, layoutInArea, positionInArea, positionInArea, pseudoClassStateChanged, queryAccessibleAttribute, registerChangeListener, registerInvalidationListener, registerListChangeListener, snappedBottomInset, snappedLeftInset, snappedRightInset, snappedTopInset, snapPosition, snapPositionX, snapPositionY, snapSize, snapSizeX, snapSizeY, snapSpace, snapSpaceX, snapSpaceY, unregisterChangeListeners, unregisterInvalidationListeners, unregisterListChangeListeners

Modifier and Type	Method	Description
protected double	computeMaxHeight(double width, double topInset, double rightInset, double bottomInset, double leftInset)	Computes the maximum allowable height of the Skin, based on the provided width.
protected double	computeMaxWidth(double height, double topInset, double rightInset, double bottomInset, double leftInset)	Computes the maximum allowable width of the Skin, based on the provided height.
protected double	computeMinHeight(double width, double topInset, double rightInset, double bottomInset, double leftInset)	Computes the minimum allowable height of the Skin, based on the provided width.
protected double	computeMinWidth(double height, double topInset, double rightInset, double bottomInset, double leftInset)	Computes the minimum allowable width of the Skin, based on the provided height.
protected double	computePrefHeight(double width, double topInset, double rightInset, double bottomInset, double leftInset)	Calculates the preferred height of this SkinBase.
protected double	computePrefWidth(double height, double topInset, double rightInset, double bottomInset, double leftInset)	Calculates the preferred width of this SkinBase.
protected final void	consumeMouseEvents(boolean value)	Determines whether all mouse events should be automatically consumed.
void	dispose()	Called when a previously installed skin is about to be removed from its associated control.
protected void	executeAccessibleAction(AccessibleAction action, Object... parameters)	This method is called by the assistive technology to request the action indicated by the argument should be executed.
final ObservableList<Node>	getChildren()	Returns the children of the skin.
List<CssMetaData<? extends Styleable, ?>>	getCssMetaData()	This method should delegate to Node.getClassCssMetaData() so that a Node's CssMetaData can be accessed without the need for reflection.
final Node	getNode()	Gets the Node which represents this Skin.
final TextArea	getSkinnable()	Gets the Skinnable to which this Skin is assigned.
protected void	layoutChildren(double contentX, double contentY, double contentWidth, double contentHeight)	Called during the layout pass of the scenegraph.
protected void	layoutInArea(Node child, double areaX, double areaY, double areaWidth, double areaHeight, double areaBaselineOffset, HPos halignment, VPos valignment)	Utility method which lays out the child within an area of this skin defined by areaX, areaY, areaWidth x areaHeight, with a baseline offset relative to that area.
protected void	layoutInArea(Node child, double areaX, double areaY, double areaWidth, double areaHeight, double areaBaselineOffset, Insets margin, boolean fillWidth, boolean fillHeight, HPos halignment, VPos valignment)	Utility method which lays out the child within an area of this skin defined by areaX, areaY, areaWidth x areaHeight, with a baseline offset relative to that area.
protected void	layoutInArea(Node child, double areaX, double areaY, double areaWidth, double areaHeight, double areaBaselineOffset, Insets margin, HPos halignment, VPos valignment)	Utility method which lays out the child within an area of this skin defined by areaX, areaY, areaWidth x areaHeight, with a baseline offset relative to that area.
protected void	positionInArea(Node child, double areaX, double areaY, double areaWidth, double areaHeight, double areaBaselineOffset, HPos halignment, VPos valignment)	Utility method which positions the child within an area of this skin defined by areaX, areaY, areaWidth x areaHeight, with a baseline offset relative to that area.
protected void	positionInArea(Node child, double areaX, double areaY, double areaWidth, double areaHeight, double areaBaselineOffset, Insets margin, HPos halignment, VPos valignment)	Utility method which positions the child within an area of this skin defined by areaX, areaY, areaWidth x areaHeight, with a baseline offset relative to that area.
final void	pseudoClassStateChanged(PseudoClass pseudoClass, boolean active)	Used to specify that a pseudo-class of this Node has changed.
protected Object	queryAccessibleAttribute(AccessibleAttribute attribute, Object... parameters)	This method is called by the assistive technology to request the value for an attribute.
protected final void	registerChangeListener(ObservableValue<?> observable, Consumer<ObservableValue<?>> operation)	Registers an operation to perform when the given observable sends a change event.
protected final void	registerInvalidationListener(Observable observable, Consumer<Observable> operation)	Registers an operation to perform when the given observable sends an invalidation event.
protected final void	registerListChangeListener(ObservableList<?> observableList, Consumer<ListChangeListener.Change<?>> operation)	Registers an operation to perform when the given observableList sends a list change event.
protected double	snappedBottomInset()	Utility method to get the bottom inset which includes padding and border inset.
protected double	snappedLeftInset()	Utility method to get the left inset which includes padding and border inset.
protected double	snappedRightInset()	Utility method to get the right inset which includes padding and border inset.
protected double	snappedTopInset()	Utility method to get the top inset which includes padding and border inset.
protected double	snapPosition(double value)	Deprecated, for removal: This API element is subject to removal in a future version. replaced by snapPositionX() and snapPositionY()
protected double	snapPositionX(double value)	Convenience method for accessing the snapPositionX() method on the skinnable.
protected double	snapPositionY(double value)	Convenience method for accessing the snapPositionY() method on the skinnable.
protected double	snapSize(double value)	Deprecated, for removal: This API element is subject to removal in a future version. replaced by snapSizeX() and snapSizeY()
protected double	snapSizeX(double value)	Convenience method for accessing the snapSizeX() method on the skinnable.
protected double	snapSizeY(double value)	Convenience method for accessing the snapSizeY() method on the skinnable.
protected double	snapSpace(double value)	Deprecated, for removal: This API element is subject to removal in a future version. replaced by snapSpaceX() and snapSpaceY()
protected double	snapSpaceX(double value)	Convenience method for accessing the snapSpaceX() method on the skinnable.
protected double	snapSpaceY(double value)	Convenience method for accessing the snapSpaceY() method on the skinnable.
protected final Consumer<ObservableValue<?>>	unregisterChangeListeners(ObservableValue<?> observable)	Unregisters all operations that have been registered using SkinBase.registerChangeListener(ObservableValue, Consumer) for the given observable.
protected final Consumer<Observable>	unregisterInvalidationListeners(Observable observable)	Unregisters all operations that have been registered using SkinBase.registerInvalidationListener(Observable, Consumer) for the given observable.
protected final Consumer<ListChangeListener.Change<?>>	unregisterListChangeListeners(ObservableList<?> observableList)	Unregisters all operations that have been registered using SkinBase.registerListChangeListener(ObservableList, Consumer) for the given observableList.

Methods declared in class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods declared in interface Skin

install

Modifier and Type	Method	Description
default void	install()	Called once when Skin is set.

Constructor Details

TextAreaSkin

public TextAreaSkin(TextArea control)

Creates a new TextAreaSkin instance, installing the necessary child nodes into the Control children list, as well as the necessary input mappings for handling key, mouse, etc events.

Parameters:

control - The control that this skin should be installed onto.

Method Details

getIndex

public HitInfo getIndex(double x,
 double y)

Performs a hit test, mapping point to index in the content.

Parameters:

x - the x coordinate of the point.

y - the y coordinate of the point.

Returns:

a HitInfo object describing the index and forward bias.

moveCaret

public void moveCaret(TextInputControlSkin.TextUnit unit,
 TextInputControlSkin.Direction dir,
 boolean select)

Moves the caret by one of the given text unit, in the given direction. Note that only certain combinations are valid, depending on the implementing subclass.

Specified by:

moveCaret in class TextInputControlSkin<TextArea>

Parameters:

unit - the unit of text to move by.

dir - the direction of movement.

select - whether to extends the selection to the new position.

getUnderlineShape

protected PathElement[] getUnderlineShape(int start,
 int end)

Gets the path elements describing the shape of the underline for the given range.

Specified by:

getUnderlineShape in class TextInputControlSkin<TextArea>

Parameters:

start - the start

end - the end

Returns:

the path elements describing the shape of the underline for the given range

getRangeShape

protected PathElement[] getRangeShape(int start,
 int end)

Gets the path elements describing the bounding rectangles for the given range of text.

Specified by:

getRangeShape in class TextInputControlSkin<TextArea>

Parameters:

start - the start

end - the end

Returns:

the path elements describing the bounding rectangles for the given range of text

addHighlight

protected void addHighlight(List<? extends Node> nodes,
 int start)

Adds highlight for composed text from Input Method.

Specified by:

addHighlight in class TextInputControlSkin<TextArea>

Parameters:

nodes - the list of nodes

start - the start

removeHighlight

protected void removeHighlight(List<? extends Node> nodes)

Removes highlight for composed text from Input Method.

Specified by:

removeHighlight in class TextInputControlSkin<TextArea>

Parameters:

nodes - the list of nodes

getCaretBounds

public Bounds getCaretBounds()

Gets the Bounds of the caret of the skinned TextArea.

Returns:

the Bounds of the caret shape, relative to the TextArea.

computeBaselineOffset

public double computeBaselineOffset(double topInset,
 double rightInset,
 double bottomInset,
 double leftInset)

Calculates the baseline offset based on the first managed child. If there is no such child, returns Node.getBaselineOffset().

Overrides:

computeBaselineOffset in class SkinBase<TextArea>

Parameters:

topInset - the pixel snapped top inset

rightInset - the pixel snapped right inset

bottomInset - the pixel snapped bottom inset

leftInset - the pixel snapped left inset

Returns:

baseline offset

positionCaret

public void positionCaret(HitInfo hit,
 boolean select)

Moves the caret to the specified position.

Parameters:

hit - the new position and forward bias of the caret.

select - whether to extend selection to the new position.