Module  java.desktop
软件包  java.awt

Class TextArea

  • All Implemented Interfaces:
    ImageObserver ， MenuContainer ， Serializable ， Accessible 

    public class TextArea
extends TextComponent
    TextArea对象是显示文本的多行区域。 它可以设置为允许编辑或只读。

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

    一个显示“Hello！”这个词的TextArea

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

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

    • 字段详细信息

      • SCROLLBARS_BOTH

        public static final int SCROLLBARS_BOTH
        创建并显示垂直和水平滚动条。
        从以下版本开始：
        1.1
        另请参见：
        Constant Field Values

      • SCROLLBARS_VERTICAL_ONLY

        public static final int SCROLLBARS_VERTICAL_ONLY
        仅创建并显示垂直滚动条。
        从以下版本开始：
        1.1
        另请参见：
        Constant Field Values

      • SCROLLBARS_HORIZONTAL_ONLY

        public static final int SCROLLBARS_HORIZONTAL_ONLY
        仅创建并显示水平滚动条。
        从以下版本开始：
        1.1
        另请参见：
        Constant Field Values

      • SCROLLBARS_NONE

        public static final int SCROLLBARS_NONE
        不要为文本区域创建或显示任何滚动条。
        从以下版本开始：
        1.1
        另请参见：
        Constant Field Values

    • 构造方法详细信息

      • 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_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

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

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

      • 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(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

        @Deprecated
public Dimension preferredSize​(int rows,
                               int columns)
        已过时。 截至JDK 1.1版，由getPreferredSize(int, int)取代。
        确定具有指定行数和列数的文本区域的首选大小。
        参数
        rows - 行数
        columns - 列数
        结果
        文本区域所需的首选尺寸

      • preferredSize

        @Deprecated
public Dimension preferredSize​()
        已过时。 从JDK 1.1版开始，由getPreferredSize()替代。
        说明从类别复制Component
        返回组件的首选大小。
        重写：
        preferredSize在 Component
        结果
        该组件的首选尺寸

      • getMinimumSize

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

      • minimumSize

        @Deprecated
public Dimension minimumSize​(int rows,
                             int columns)
        已过时。 从JDK 1.1版开始，由getMinimumSize(int, int)替代。
        确定具有指定行数和列数的文本区域的最小大小。
        参数
        rows - 行数
        columns - 列数
        结果
        文本区域的最小大小

      • minimumSize

        @Deprecated
public Dimension minimumSize​()
        已过时。 从JDK 1.1版开始，由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