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

- Field Detail
  - 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
- Constructor Detail
  - 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_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外观没有任何改变它的功能。
    
    重写：
    
    addNotify 方法重写，继承类 TextComponent
    
    另请参见：
    
    TextComponent.removeNotify()
  - insert
```
public void insert(String str,
                   int pos)
```
    在该文本区域中的指定位置插入指定的文本。
    注意，通过null或不一致的参数无效，将导致未指定的行为。
    
    参数
    
    str -插入non- 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 -附加的non- 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 -作为替代的non- 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()
```
    返回文本区域中的行数。
    
    结果
    
    文本区域中的行数
    
    从以下版本开始：
    
    一
    
    另请参见：
    
    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作为本 TextArea的 AccessibleContext
    
    从以下版本开始：
    
    一点三

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

Field Detail

SCROLLBARS_BOTH

SCROLLBARS_VERTICAL_ONLY

SCROLLBARS_HORIZONTAL_ONLY

SCROLLBARS_NONE

Constructor Detail

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