Module java.desktop
Package java.awt

Class 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对象是一个显示文本的多行区域。它可以设置为允许编辑或只读。

以下图片显示了文本区域的外观:

显示单词'Hello!'的文本区域

可以通过以下代码创建此文本区域:

 new TextArea("Hello", 5, 40);
自版本:
1.0
另请参阅:

  • Field Details

    • 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
      另请参阅:

  • Constructor Details

    • TextArea

      public TextArea() throws HeadlessException
      用空字符串文本构造一个新的文本区域。此文本区域是使用滚动条可见性等于SCROLLBARS_BOTH创建的，因此此文本区域将同时显示垂直和水平滚动条。
      抛出:
      HeadlessException - 如果GraphicsEnvironment.isHeadless返回true
      另请参阅:

    • TextArea

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

    • TextArea

      public TextArea(int rows, int columns) throws HeadlessException
      用指定行数和列数以及空字符串文本构造一个新的文本区域。列是一个平台相关的近似平均字符宽度。此文本区域是使用滚动条可见性等于SCROLLBARS_BOTH创建的，因此此文本区域将同时显示垂直和水平滚动条。
      参数:
      rows - 行数
      columns - 列数
      抛出:
      HeadlessException - 如果GraphicsEnvironment.isHeadless返回true
      另请参阅:

    • TextArea

      public TextArea(String text, int rows, int columns) throws HeadlessException
      用指定文本、行数和列数构造一个新的文本区域。列是一个平台相关的近似平均字符宽度。此文本区域是使用滚动条可见性等于SCROLLBARS_BOTH创建的，因此此文本区域将同时显示垂直和水平滚动条。
      参数:
      text - 要显示的文本；如果text为null，则显示空字符串""
      rows - 行数
      columns - 列数
      抛出:
      HeadlessException - 如果GraphicsEnvironment.isHeadless返回true
      另请参阅:

    • 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
      自版本:
      1.1
      另请参阅:

  • Method Details

    • 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)
      Deprecated.
      As of JDK version 1.1, replaced by insert(String, int).
      在此文本区域的指定位置插入指定的文本。
      参数：
      str - 要插入的非null文本
      pos - 要插入的位置

    • append

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

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

      参数：
      str - 要附加的非null文本
      自：
      1.1
      另请参阅：

    • appendText

      @Deprecated public void appendText(String str)
      Deprecated.
      As of JDK version 1.1, replaced by 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)
      Deprecated.
      As of JDK version 1.1, replaced by 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)
      Deprecated.
      As of JDK version 1.1, replaced by getPreferredSize(int, int).
      确定具有指定行数和列数的文本区域的首选大小。
      参数：
      rows - 行数
      columns - 列数
      返回：
      文本区域所需的首选尺寸

    • getPreferredSize

      public Dimension getPreferredSize()
      确定此文本区域的首选大小。
      覆盖：
      getPreferredSize 在类中 Component
      返回：
      此文本区域所需的首选尺寸
      自：
      1.1
      另请参阅：

    • preferredSize

      @Deprecated public Dimension preferredSize()
      Deprecated.
      As of JDK version 1.1, replaced by 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)
      Deprecated.
      As of JDK version 1.1, replaced by getMinimumSize(int, int).
      确定具有指定行数和列数的文本区域的最小大小。
      参数：
      rows - 行数
      columns - 列数
      返回：
      文本区域的最小尺寸

    • getMinimumSize

      public Dimension getMinimumSize()
      确定此文本区域的最小大小。
      覆盖：
      getMinimumSize 在类中 Component
      返回：
      此文本区域所需的最小尺寸
      自：
      1.1
      另请参阅：

    • minimumSize

      @Deprecated public Dimension minimumSize()
      Deprecated.
      As of JDK version 1.1, replaced by 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
      返回：
      作为此TextArea的AccessibleContext的AccessibleAWTTextArea
      自：
      1.3