TextArea (Java Platform SE 8 )

java.lang.Object
- java.awt.Component
- - java.awt.TextComponent
  - - java.awt.TextArea

All Implemented Interfaces:

ImageObserver ， MenuContainer ， Serializable ， Accessible
```
public class TextArea
extends TextComponent
```
TextArea对象是显示文本的多行区域。它可以设置为允许编辑或只读。
以下图像显示文本区域的外观：

此文本区域可以通过以下代码行创建：
```
 new TextArea("Hello", 5, 40);
 
```
从以下版本开始：

JDK1.0

另请参见：

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected class`	`TextArea.AccessibleAWTTextArea` 该类实现对 `TextArea`类的辅助功能支持。

Nested classes/interfaces inherited from class java.awt.TextComponent
TextComponent.AccessibleAWTTextComponent

Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`SCROLLBARS_BOTH` 创建并显示垂直和水平滚动条。
`static int`	`SCROLLBARS_HORIZONTAL_ONLY` 仅创建并显示水平滚动条。
`static int`	`SCROLLBARS_NONE` 不要为文本区域创建或显示任何滚动条。
`static int`	`SCROLLBARS_VERTICAL_ONLY` 仅创建并显示垂直滚动条。

Fields inherited from class java.awt.TextComponent
textListener

Fields inherited from class java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

构造方法摘要

构造方法
Constructor and Description
`TextArea()` 构造一个新的文本区域，空字符串作为文本。
`TextArea(int rows, int columns)` 构造具有指定行数和列数的新文本区域，空字符串作为文本。
`TextArea(String text)` 构造具有指定文本的新文本区域。
`TextArea(String text, int rows, int columns)` 构造具有指定文本的新文本区域，并具有指定的行数和列数。
`TextArea(String text, int rows, int columns, int scrollbars)` 构造具有指定文本的新文本区域，并按照指定的行，列和滚动条可见性构造。

方法摘要

所有方法接口方法具体的方法弃用的方法
Modifier and Type	Method and Description
`void`	`addNotify()` 创建 `TextArea`的同伴。
`void`	`append(String str)` 将给定的文本附加到文本区域的当前文本。
`void`	`appendText(String str)` 已弃用截至JDK 1.1版，由`append(String)`取代。
`AccessibleContext`	`getAccessibleContext()` 返回 `AccessibleContext`与此相关 `TextArea` 。
`int`	`getColumns()` 返回此文本区域中的列数。
`Dimension`	`getMinimumSize()` 确定此文本区域的最小大小。
`Dimension`	`getMinimumSize(int rows, int columns)` 确定具有指定行数和列数的文本区域的最小大小。
`Dimension`	`getPreferredSize()` 确定此文本区域的首选大小。
`Dimension`	`getPreferredSize(int rows, int columns)` 确定具有指定行数和列数的文本区域的首选大小。
`int`	`getRows()` 返回文本区域中的行数。
`int`	`getScrollbarVisibility()` 返回枚举值，指示文本区域使用的滚动条。
`void`	`insert(String str, int pos)` 在此文本区域的指定位置插入指定的文本。
`void`	`insertText(String str, int pos)` 已弃用截至JDK 1.1版，由`insert(String, int)`取代。
`Dimension`	`minimumSize()` 已弃用截至JDK 1.1版，由`getMinimumSize()`取代。
`Dimension`	`minimumSize(int rows, int columns)` 已弃用从JDK 1.1版开始，替换为`getMinimumSize(int, int)` 。
`protected String`	`paramString()` 返回一个表示此 `TextArea`状态的字符串。
`Dimension`	`preferredSize()` 已弃用从JDK 1.1版开始，由`getPreferredSize()` 。
`Dimension`	`preferredSize(int rows, int columns)` 已弃用从JDK 1.1版开始，由`getPreferredSize(int, int)`替换。
`void`	`replaceRange(String str, int start, int end)` 将指定的开始和结束位置之间的文本替换为指定的替换文本。
`void`	`replaceText(String str, int start, int end)` 已弃用截至JDK 1.1版，由`replaceRange(String, int, int)` 。
`void`	`setColumns(int columns)` 设置此文本区域的列数。
`void`	`setRows(int rows)` 设置此文本区域的行数。

Methods inherited from class java.awt.TextComponent
addTextListener, enableInputMethods, getBackground, getCaretPosition, getInputMethodRequests, getListeners, getSelectedText, getSelectionEnd, getSelectionStart, getText, getTextListeners, isEditable, processEvent, processTextEvent, removeNotify, removeTextListener, select, selectAll, setBackground, setCaretPosition, setEditable, setSelectionEnd, setSelectionStart, setText

Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 字段详细信息
  - SCROLLBARS_BOTH
```
public static final int SCROLLBARS_BOTH
```
    创建并显示垂直和水平滚动条。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    Constant Field Values
  - SCROLLBARS_VERTICAL_ONLY
```
public static final int SCROLLBARS_VERTICAL_ONLY
```
    仅创建并显示垂直滚动条。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    Constant Field Values
  - SCROLLBARS_HORIZONTAL_ONLY
```
public static final int SCROLLBARS_HORIZONTAL_ONLY
```
    仅创建并显示水平滚动条。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    Constant Field Values
  - SCROLLBARS_NONE
```
public static final int SCROLLBARS_NONE
```
    不要为文本区域创建或显示任何滚动条。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    Constant Field Values
- 构造方法详细信息
  - TextArea
```
public TextArea()
         throws HeadlessException
```
    构造一个新的文本区域，空字符串作为文本。此文本区域的创建滚动条可见性等于SCROLLBARS_BOTH ，因此此文本区域的垂直和水平滚动条都将可见。
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless返回true
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - TextArea
```
public TextArea(String text)
         throws HeadlessException
```
    构造具有指定文本的新文本区域。此文本区域的创建滚动条可见性等于SCROLLBARS_BOTH ，因此此文本区域的垂直和水平滚动条都将可见。
    
    参数
    
    text - 要显示的文字; 如果text是null ，空字符串""将被显示
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless返回true
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - TextArea
```
public TextArea(int rows,
                int columns)
         throws HeadlessException
```
    构造具有指定行数和列数的新文本区域，空字符串作为文本。一列是平台相关的近似平均字符宽度。文本区域的创建方式为滚动条的可视性等于SCROLLBARS_BOTH ，因此此文本区域的垂直和水平滚动条都将可见。
    
    参数
    
    rows - 行数
    
    columns - 列的数量
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless返回true
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - TextArea
```
public TextArea(String text,
                int rows,
                int columns)
         throws HeadlessException
```
    构造具有指定文本的新文本区域，并具有指定的行数和列数。一列是平台相关的近似平均字符宽度。文本区域的创建方式为滚动条的可视性等于SCROLLBARS_BOTH ，因此此文本区域的垂直和水平滚动条都将可见。
    
    参数
    
    text - 要显示的文字; 如果text是null ，空字符串""将被显示
    
    rows - 行数
    
    columns - 列数
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless返回true
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - TextArea
```
public TextArea(String text,
                int rows,
                int columns,
                int scrollbars)
         throws HeadlessException
```
    构造具有指定文本的新文本区域，并按照指定的行，列和滚动条可见性构造。所有TextArea遵循这一个。
    TextArea类定义了可以作为scrollbars参数的值提供的scrollbars ：
    - SCROLLBARS_BOTH ，
    - SCROLLBARS_VERTICAL_ONLY ，
    - SCROLLBARS_HORIZONTAL_ONLY ，
    - SCROLLBARS_NONE 。
    scrollbars参数的任何其他值无效，并且将导致此文本区域被创建，其滚动条可见性等于默认值SCROLLBARS_BOTH 。
    参数
    
    text - 要显示的文字; 如果text是null ，空字符串""将显示
    
    rows - 行数; 如果rows小于0 ，则rows设置为0
    
    columns - 列数; 如果columns小于0 ，则columns设置为0
    
    scrollbars - 一个常量，用于确定创建的滚动条以查看文本区域
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless返回true
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
- 方法详细信息
  - addNotify
```
public void addNotify()
```
    创建TextArea的同伴。对等体允许我们修改TextArea的TextArea而不改变它的任何功能。
    
    重写：
    
    addNotify在 TextComponent
    
    另请参见：
    
    TextComponent.removeNotify()
  - insert
```
public void insert(String str,
                   int pos)
```
    在此文本区域的指定位置插入指定的文本。
    请注意，传递null或参数不一致将导致未指定的行为。
    
    参数
    
    str - 非 null文本插入
    
    pos - 要插入的位置
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    TextComponent.setText(java.lang.String) ， replaceRange(java.lang.String, int, int) ， append(java.lang.String)
  - insertText
```
@Deprecated
public void insertText(String str,
                                   int pos)
```
    已弃用从JDK 1.1版开始，由insert(String, int) 。
  - append
```
public void append(String str)
```
    将给定的文本附加到文本区域的当前文本。
    请注意，传递null或参数不一致将导致未指定的行为。
    
    参数
    
    str - 要附加的非 null文本
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    insert(java.lang.String, int)
  - appendText
```
@Deprecated
public void appendText(String str)
```
    已弃用从JDK 1.1版开始，替换为append(String) 。
  - replaceRange
```
public void replaceRange(String str,
                         int start,
                         int end)
```
    将指定的开始和结束位置之间的文本替换为指定的替换文本。最终位置的文本将不被替换。起始位置的文本将被替换（除非起始位置与最终位置相同）。文本位置为零。插入的子字符串可能与其替换的文本的长度不同。
    请注意，传递null或参数不一致将导致未指定的行为。
    
    参数
    
    str - 非 null文字用作替代
    
    start - 起始位置
    
    end - 结束位置
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    insert(java.lang.String, int)
  - replaceText
```
@Deprecated
public void replaceText(String str,
                                    int start,
                                    int end)
```
    已弃用从JDK 1.1版开始，替换为replaceRange(String, int, int) 。
  - getRows
```
public int getRows()
```
    返回文本区域中的行数。
    
    结果
    
    文本区域中的行数
    
    从以下版本开始：
    
    JDK1
    
    另请参见：
    
    setRows(int) ， getColumns()
  - setRows
```
public void setRows(int rows)
```
    设置此文本区域的行数。
    
    参数
    
    rows - 行数
    
    异常
    
    IllegalArgumentException - 如果为 rows提供的值小于 0
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    getRows() ， setColumns(int)
  - getColumns
```
public int getColumns()
```
    返回此文本区域中的列数。
    
    结果
    
    文本区域中的列数
    
    另请参见：
    
    setColumns(int) ， getRows()
  - setColumns
```
public void setColumns(int columns)
```
    设置此文本区域的列数。
    
    参数
    
    columns - 列数
    
    异常
    
    IllegalArgumentException - 如果提供给 columns的值小于 0
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    getColumns() ， setRows(int)
  - getScrollbarVisibility
```
public int getScrollbarVisibility()
```
    返回枚举值，指示文本区域使用的滚动条。
    TextArea类定义了四个整数常量，用于指定哪些滚动条可用。 TextArea有一个构造函数，它允许应用程序自动选择滚动条。
    
    结果
    
    一个指示使用哪个滚动条的整数
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    SCROLLBARS_BOTH ， SCROLLBARS_VERTICAL_ONLY ， SCROLLBARS_HORIZONTAL_ONLY ， SCROLLBARS_NONE ， TextArea(java.lang.String, int, int, int)
  - getPreferredSize
```
public Dimension getPreferredSize(int rows,
                                  int columns)
```
    确定具有指定行数和列数的文本区域的首选大小。
    
    参数
    
    rows - 行数
    
    columns - 列数
    
    结果
    
    显示具有指定行数和列数的文本区域所需的首选尺寸
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    Component.getPreferredSize()
  - preferredSize
```
@Deprecated
public Dimension preferredSize(int rows,
                                           int columns)
```
    已弃用从JDK 1.1版开始，由getPreferredSize(int, int) 。
  - getPreferredSize
```
public Dimension getPreferredSize()
```
    确定此文本区域的首选大小。
    
    重写：
    
    getPreferredSize在 Component
    
    结果
    
    此文本区域所需的首选尺寸
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    Component.getPreferredSize()
  - preferredSize
```
@Deprecated
public Dimension preferredSize()
```
    已弃用从JDK 1.1版开始，替换为getPreferredSize() 。
    
    重写：
    
    preferredSize在 Component
  - getMinimumSize
```
public Dimension getMinimumSize(int rows,
                                int columns)
```
    确定具有指定行数和列数的文本区域的最小大小。
    
    参数
    
    rows - 行数
    
    columns - 列数
    
    结果
    
    显示具有指定行数和列数的文本区域所需的最小尺寸
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    Component.getMinimumSize()
  - minimumSize
```
@Deprecated
public Dimension minimumSize(int rows,
                                         int columns)
```
    已弃用从JDK 1.1版开始，替换为getMinimumSize(int, int) 。
  - getMinimumSize
```
public Dimension getMinimumSize()
```
    确定此文本区域的最小大小。
    
    重写：
    
    getMinimumSize在类别 Component
    
    结果
    
    此文本区域所需的首选尺寸
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    Component.getPreferredSize()
  - minimumSize
```
@Deprecated
public Dimension minimumSize()
```
    已弃用从JDK 1.1版开始，替换为getMinimumSize() 。
    
    重写：
    
    minimumSize在 Component
  - paramString
```
protected String paramString()
```
    返回表示此TextArea的状态的字符串。该方法仅用于调试目的，并且返回的字符串的内容和格式可能因实现而异。返回的字符串可能为空，但可能不是null 。
    
    重写：
    
    paramString在类别 TextComponent
    
    结果
    
    此文本区域的参数字符串
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    返回AccessibleContext与此相关TextArea 。对于文本区， AccessibleContext需要一个形式AccessibleAWTTextArea 。如果需要，将创建一个新的AccessibleAWTTextArea实例。
    
    Specified by:
    
    getAccessibleContext在界面 Accessible
    
    重写：
    
    getAccessibleContext在类别 TextComponent
    
    结果
    
    一个 AccessibleAWTTextArea ，作为 AccessibleContext的这个 TextArea
    
    从以下版本开始：
    
    1.3

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class TextArea

Nested Class Summary

Nested classes/interfaces inherited from class java.awt.TextComponent

Nested classes/interfaces inherited from class java.awt.Component

Field Summary

Fields inherited from class java.awt.TextComponent

Fields inherited from class java.awt.Component

Fields inherited from interface java.awt.image.ImageObserver

构造方法摘要

方法摘要

Methods inherited from class java.awt.TextComponent

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

字段详细信息

SCROLLBARS_BOTH

SCROLLBARS_VERTICAL_ONLY

SCROLLBARS_HORIZONTAL_ONLY

SCROLLBARS_NONE

构造方法详细信息

TextArea

TextArea

TextArea

TextArea

TextArea

方法详细信息

addNotify

insert

insertText

append

appendText

replaceRange

replaceText

getRows

setRows

getColumns

setColumns

getScrollbarVisibility

getPreferredSize

preferredSize

getPreferredSize

preferredSize

getMinimumSize

minimumSize

getMinimumSize

minimumSize

paramString

getAccessibleContext