模块  java.desktop
软件包  java.awt

Class TextArea

  • 实现的所有接口
    ImageObserver ， MenuContainer ， Serializable ， Accessible 
    public class TextAreaextends TextComponent
    TextArea对象是显示文本的多行区域。 它可以设置为允许编辑或只读。

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

    TextArea显示单词'Hello！'

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

     new TextArea("Hello", 5, 40);
    从以下版本开始：
    1.0
    另请参见：
    Serialized Form

    • 字段详细信息

      • 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​(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这一个。

        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
        从以下版本开始：
        1.1
        另请参见：
        GraphicsEnvironment.isHeadless()

    • 方法详细信息

      • insertText

        @Deprecatedpublic 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
        另请参见：
        insert(java.lang.String, int)

      • appendText

        @Deprecatedpublic 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
        另请参见：
        insert(java.lang.String, int)

      • replaceText

        @Deprecatedpublic 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(int) ， getColumns()

      • setRows

        public void setRows​(int rows)
        设置此文本区域的行数。
        参数
        rows - 行数
        异常
        IllegalArgumentException - 如果为 rows提供的值小于 0
        从以下版本开始：
        1.1
        另请参见：
        getRows() ， setColumns(int)

      • getColumns

        public int getColumns()
        返回此文本区域中的列数。
        结果
        文本区域中的列数
        另请参见：
        setColumns(int) ， getRows()

      • setColumns

        public void setColumns​(int columns)
        设置此文本区域的列数。
        参数
        columns - 列数
        异常
        IllegalArgumentException - 如果为 columns提供的值小于 0
        从以下版本开始：
        1.1
        另请参见：
        getColumns() ， setRows(int)

      • getPreferredSize

        public Dimension getPreferredSize​(int rows,                                  int columns)
        确定具有指定行数和列数的文本区域的首选大小。
        参数
        rows - 行数
        columns - 列数
        结果
        显示具有指定行数和列数的文本区域所需的首选尺寸
        从以下版本开始：
        1.1
        另请参见：
        Component.getPreferredSize()

      • preferredSize

        @Deprecatedpublic Dimension preferredSize​(int rows,                               int columns)
        Deprecated.
        As of JDK version 1.1, replaced by getPreferredSize(int, int).
        确定具有指定行数和列数的文本区域的首选大小。
        参数
        rows - 行数
        columns - 列数
        结果
        文本区域所需的首选尺寸

      • preferredSize

        @Deprecatedpublic 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
        另请参见：
        Component.getMinimumSize()

      • minimumSize

        @Deprecatedpublic Dimension minimumSize​(int rows,                             int columns)
        Deprecated.
        As of JDK version 1.1, replaced by getMinimumSize(int, int).
        确定具有指定行数和列数的文本区域的最小大小。
        参数
        rows - 行数
        columns - 列数
        结果
        文本区域的最小大小

      • minimumSize

        @Deprecatedpublic 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()
        返回与AccessibleContext相关联的TextArea 。 对于文本区， AccessibleContext需要一个形式AccessibleAWTTextArea 。 如有必要，将创建一个新的AccessibleAWTTextArea实例。
        Specified by:
        getAccessibleContext ，界面 Accessible
        重写：
        getAccessibleContext在类 TextComponent
        结果
        AccessibleAWTTextArea ，作为 AccessibleContext的 TextArea
        从以下版本开始：
        1.3