模块 java.desktop
包 java.awt

类 TextArea

java.lang.Object
java.awt.Component
java.awt.TextComponent
java.awt.TextArea
所有已实现的接口：
ImageObserver , MenuContainer , Serializable , Accessible
public non-sealed class TextArea extends TextComponent
TextArea 对象是显示文本的多行区域。它可以设置为允许编辑或只读。

下图显示了文本区域的外观：

A TextArea showing the word 'Hello!'

该文本区域可以通过以下代码行创建：

 new TextArea("Hello", 5, 40);
自从：
1.0
参见：

  • 字段详细信息

    • SCROLLBARS_BOTH

      public static final int SCROLLBARS_BOTH
      创建并显示垂直和水平滚动条。
      自从：
      1.1
      参见：

    • SCROLLBARS_VERTICAL_ONLY

      public static final int SCROLLBARS_VERTICAL_ONLY
      仅创建和显示垂直滚动条。
      自从：
      1.1
      参见：

    • SCROLLBARS_HORIZONTAL_ONLY

      public static final int SCROLLBARS_HORIZONTAL_ONLY
      仅创建和显示水平滚动条。
      自从：
      1.1
      参见：

    • SCROLLBARS_NONE

      public static final int SCROLLBARS_NONE
      不要为文本区域创建或显示任何滚动条。
      自从：
      1.1
      参见：

  • 构造方法详细信息

    • TextArea

      public TextArea() throws HeadlessException
      以空字符串作为文本构造一个新的文本区域。此文本区域创建时滚动条可见性等于 SCROLLBARS_BOTH ，因此此文本区域的垂直和水平滚动条都将可见。
      抛出：
      HeadlessException - 如果 GraphicsEnvironment.isHeadless 返回真
      参见：

    • TextArea

      public TextArea(String  text) throws HeadlessException
      用指定的文本构造一个新的文本区域。此文本区域创建时滚动条可见性等于 SCROLLBARS_BOTH ，因此此文本区域的垂直和水平滚动条都将可见。
      参数：
      text - 要显示的文本；如果 text 是 null ，将显示空字符串 ""
      抛出：
      HeadlessException - 如果 GraphicsEnvironment.isHeadless 返回真
      参见：

    • TextArea

      public TextArea(int rows, int columns) throws HeadlessException
      构造一个具有指定行数和列数以及空字符串作为文本的新文本区域。列是与平台相关的近似平均字符宽度。创建的文本区域的滚动条可见性等于 SCROLLBARS_BOTH ，因此该文本区域的垂直和水平滚动条都将可见。
      参数：
      rows - 行数
      columns - 列数
      抛出：
      HeadlessException - 如果 GraphicsEnvironment.isHeadless 返回真
      参见：

    • TextArea

      public TextArea(String  text, int rows, int columns) throws HeadlessException
      构造一个具有指定文本以及指定行数和列数的新文本区域。列是与平台相关的近似平均字符宽度。创建的文本区域的滚动条可见性等于 SCROLLBARS_BOTH ，因此该文本区域的垂直和水平滚动条都将可见。
      参数：
      text - 要显示的文本；如果 text 是 null ，将显示空字符串 ""
      rows - 行数
      columns - 列数
      抛出：
      HeadlessException - 如果 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 返回真
      自从：
      1.1
      参见：

  • 方法详情

    • addNotify

      public void addNotify()
      创建 TextArea 的对等体。对等点允许我们修改 TextArea 的外观而不更改其任何功能。
      重写：
      addNotify 在类 TextComponent 中
      参见：

    • insert

      public void insert(String  str, int pos)
      在此文本区域中的指定位置插入指定的文本。

      请注意，传递 null 或不一致的参数是无效的，并且会导致未指定的行为。

      参数：
      str - 要插入的非 null 文本
      pos - 插入的位置
      自从：
      1.1
      参见：

    • insertText

      @Deprecated public void insertText(String  str, int pos)
      已弃用。
      从 JDK 1.1 版开始，由 insert(String, int) 取代。
      在此文本区域中的指定位置插入指定的文本。
      参数：
      str - 要插入的非 null 文本
      pos - 插入的位置

    • append

      public void append(String  str)
      将给定文本附加到文本区域的当前文本。

      请注意，传递 null 或不一致的参数是无效的，并且会导致未指定的行为。

      参数：
      str - 要附加的非 null 文本
      自从：
      1.1
      参见：

    • appendText

      @Deprecated public void appendText(String  str)
      已弃用。
      从 JDK 1.1 版开始，由 append(String) 取代。
      将给定文本附加到文本区域的当前文本。
      参数：
      str - 要附加的文本

    • replaceRange

      public void replaceRange(String  str, int start, int end)
      用指定的替换文本替换指定的开始和结束位置之间的文本。结束位置的文本不会被替换。开始位置的文本将被替换（除非开始位置与结束位置相同）。文本位置从零开始。插入的子字符串的长度可能与其替换的文本的长度不同。

      请注意，传递 null 或不一致的参数是无效的，并且会导致未指定的行为。

      参数：
      str - 用作替换的非 null 文本
      start - 起始位置
      end - 结束位置
      自从：
      1.1
      参见：

    • replaceText

      @Deprecated public void replaceText(String  str, int start, int end)
      已弃用。
      从 JDK 1.1 版开始，由 replaceRange(String, int, int) 取代。
      用指定的替换文本替换指定的开始和结束位置之间的字符范围（结束位置的文本不会被替换）。
      参数：
      str - 用作替换的非 null 文本
      start - 起始位置
      end - 结束位置

    • getRows

      public int getRows()
      返回文本区域中的行数。
      返回：
      文本区域中的行数
      自从：
      1.0
      参见：

    • setRows

      public void setRows(int rows)
      设置此文本区域的行数。
      参数：
      rows - 行数
      抛出：
      IllegalArgumentException - 如果为 rows 提供的值小于 0
      自从：
      1.1
      参见：

    • getColumns

      public int getColumns()
      返回此文本区域中的列数。
      返回：
      文本区域中的列数
      参见：

    • setColumns

      public void setColumns(int columns)
      设置此文本区域的列数。
      参数：
      columns - 列数
      抛出：
      IllegalArgumentException - 如果为 columns 提供的值小于 0
      自从：
      1.1
      参见：

    • getScrollbarVisibility

      public int getScrollbarVisibility()
      返回一个枚举值，指示文本区域使用的滚动条。

      TextArea 类定义了四个整数常量，用于指定哪些滚动条可用。 TextArea 有一个构造函数可以让应用程序自行决定滚动条。

      返回：
      一个整数，指示使用了哪些滚动条
      自从：
      1.1
      参见：

    • getPreferredSize

      public Dimension  getPreferredSize(int rows, int columns)
      确定具有指定行数和列数的文本区域的首选大小。
      参数：
      rows - 行数
      columns - 列数
      返回：
      显示具有指定行数和列数的文本区域所需的首选尺寸
      自从：
      1.1
      参见：

    • preferredSize

      @Deprecated public Dimension  preferredSize(int rows, int columns)
      已弃用。
      从 JDK 1.1 版开始，由 getPreferredSize(int, int) 取代。
      确定具有指定行数和列数的文本区域的首选大小。
      参数：
      rows - 行数
      columns - 列数
      返回：
      文本区域所需的首选尺寸

    • getPreferredSize

      public Dimension  getPreferredSize()
      确定此文本区域的首选大小。
      重写：
      getPreferredSize 在类 Component 中
      返回：
      此文本区域所需的首选尺寸
      自从：
      1.1
      参见：

    • preferredSize

      @Deprecated public Dimension  preferredSize()
      已弃用。
      从 JDK 1.1 版开始，由 getPreferredSize() 取代。
      从类复制的描述：Component
      返回组件的首选大小。
      重写：
      preferredSize 在类 Component 中
      返回：
      组件的首选大小

    • getMinimumSize

      public Dimension  getMinimumSize(int rows, int columns)
      确定具有指定行数和列数的文本区域的最小大小。
      参数：
      rows - 行数
      columns - 列数
      返回：
      显示具有指定行数和列数的文本区域所需的最小尺寸
      自从：
      1.1
      参见：

    • minimumSize

      @Deprecated public Dimension  minimumSize(int rows, int columns)
      已弃用。
      从 JDK 1.1 版开始，由 getMinimumSize(int, int) 取代。
      确定具有指定行数和列数的文本区域的最小大小。
      参数：
      rows - 行数
      columns - 列数
      返回：
      文本区域的最小尺寸

    • getMinimumSize

      public Dimension  getMinimumSize()
      确定此文本区域的最小大小。
      重写：
      getMinimumSize 在类 Component 中
      返回：
      此文本区域所需的首选尺寸
      自从：
      1.1
      参见：

    • minimumSize

      @Deprecated public Dimension  minimumSize()
      已弃用。
      从 JDK 1.1 版开始，由 getMinimumSize() 取代。
      从类复制的描述：Component
      返回此组件的最小尺寸。
      重写：
      minimumSize 在类 Component 中
      返回：
      该组件的最小尺寸

    • paramString

      protected String  paramString()
      返回表示此 TextArea 状态的字符串。此方法仅用于调试目的，返回字符串的内容和格式可能因实现而异。返回的字符串可能为空，但可能不是 null 。
      重写：
      paramString 在类 TextComponent 中
      返回：
      该文本区域的参数字符串

    • getAccessibleContext

      public AccessibleContext  getAccessibleContext()
      返回与此 TextArea 关联的 AccessibleContext。对于文本区域，AccessibleContext 采用 AccessibleAWTTextArea 的形式。如有必要，将创建一个新的 AccessibleAWTTextArea 实例。
      指定者：
      getAccessibleContext 在接口 Accessible 中
      重写：
      getAccessibleContext 在类 TextComponent 中
      返回：
      一个 AccessibleAWTTextArea 作为这个 TextArea 的 AccessibleContext
      自从：
      1.3