模块  java.desktop
软件包  java.awt

Class TextArea

  • 实现的所有接口
    ImageObserverMenuContainerSerializableAccessible

    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 - 要显示的文本; 如果textnull ,将显示空字符串""
        异常
        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 - 要显示的文本; 如果textnull ,将显示空字符串""
        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 - 要显示的文本; 如果textnull ,将显示空字符串""
        rows - 行数; 如果rows小于0rows设置为0
        columns - 列数; 如果columns小于0columns设置为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 ,作为 AccessibleContextTextArea
        从以下版本开始:
        1.3