java.awt.TextArea

All Implemented Interfaces:: ImageObserver, MenuContainer, Serializable, Accessible

public class TextArea
extends TextComponent

A TextArea object is a multi-line region that displays text. It can be set to allow editing or to be read-only.

The following image shows the appearance of a text area:

A TextArea showing the word 'Hello!'

This text area could be created by the following line of code:

 new TextArea("Hello", 5, 40);

Since:: 1.0
See Also:: Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type Class Description

protected class TextArea.AccessibleAWTTextArea
This class implements accessibility support for the TextArea class.

Nested classes/interfaces declared in class java.awt.TextComponent
TextComponent.AccessibleAWTTextComponent

Nested classes/interfaces declared in class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields
Modifier and Type	Field	Description
`static int`	`SCROLLBARS_BOTH`	Create and display both vertical and horizontal scrollbars.
`static int`	`SCROLLBARS_HORIZONTAL_ONLY`	Create and display horizontal scrollbar only.
`static int`	`SCROLLBARS_NONE`	Do not create or display any scrollbars for the text area.
`static int`	`SCROLLBARS_VERTICAL_ONLY`	Create and display vertical scrollbar only.

Fields declared in class java.awt.TextComponent

textListener

Fields declared in class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields declared in interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors
Constructor	Description
`TextArea()`	Constructs a new text area with the empty string as text.
`TextArea(int rows, int columns)`	Constructs a new text area with the specified number of rows and columns and the empty string as text.
`TextArea(String text)`	Constructs a new text area with the specified text.
`TextArea(String text, int rows, int columns)`	Constructs a new text area with the specified text, and with the specified number of rows and columns.
`TextArea(String text, int rows, int columns, int scrollbars)`	Constructs a new text area with the specified text, and with the rows, columns, and scroll bar visibility as specified.

Method Summary

Modifier and Type	Method	Description
`void`	`addNotify()`	Creates the `TextArea`'s peer.
`void`	`append(String str)`	Appends the given text to the text area's current text.
`void`	`appendText(String str)`	Deprecated. As of JDK version 1.1, replaced by `append(String)`.
`AccessibleContext`	`getAccessibleContext()`	Returns the `AccessibleContext` associated with this `TextArea`.
`int`	`getColumns()`	Returns the number of columns in this text area.
`Dimension`	`getMinimumSize()`	Determines the minimum size of this text area.
`Dimension`	`getMinimumSize(int rows, int columns)`	Determines the minimum size of a text area with the specified number of rows and columns.
`Dimension`	`getPreferredSize()`	Determines the preferred size of this text area.
`Dimension`	`getPreferredSize(int rows, int columns)`	Determines the preferred size of a text area with the specified number of rows and columns.
`int`	`getRows()`	Returns the number of rows in the text area.
`int`	`getScrollbarVisibility()`	Returns an enumerated value that indicates which scroll bars the text area uses.
`void`	`insert(String str, int pos)`	Inserts the specified text at the specified position in this text area.
`void`	`insertText(String str, int pos)`	Deprecated. As of JDK version 1.1, replaced by `insert(String, int)`.
`Dimension`	`minimumSize()`	Deprecated. As of JDK version 1.1, replaced by `getMinimumSize()`.
`Dimension`	`minimumSize(int rows, int columns)`	Deprecated. As of JDK version 1.1, replaced by `getMinimumSize(int, int)`.
`protected String`	`paramString()`	Returns a string representing the state of this `TextArea`.
`Dimension`	`preferredSize()`	Deprecated. As of JDK version 1.1, replaced by `getPreferredSize()`.
`Dimension`	`preferredSize(int rows, int columns)`	Deprecated. As of JDK version 1.1, replaced by `getPreferredSize(int, int)`.
`void`	`replaceRange(String str, int start, int end)`	Replaces text between the indicated start and end positions with the specified replacement text.
`void`	`replaceText(String str, int start, int end)`	Deprecated. As of JDK version 1.1, replaced by `replaceRange(String, int, int)`.
`void`	`setColumns(int columns)`	Sets the number of columns for this text area.
`void`

Class TextArea

Nested Class Summary

Nested classes/interfaces declared in class java.awt.TextComponent