|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.awt.Component java.awt.TextComponent java.awt.TextArea
public class TextArea
TextArea
对象是显示文本的多行区域。可以将它设置为允许编辑或只读。
下图显示了文本区的外观:
此文本区可以使用以下代码行来创建:
new TextArea("Hello", 5, 40);
嵌套类摘要 | |
---|---|
protected class |
TextArea.AccessibleAWTTextArea 此类实现 TextArea 类的可访问性支持。 |
从类 java.awt.TextComponent 继承的嵌套类/接口 |
---|
TextComponent.AccessibleAWTTextComponent |
从类 java.awt.Component 继承的嵌套类/接口 |
---|
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy |
字段摘要 | |
---|---|
static int |
SCROLLBARS_BOTH 创建并显示垂直和水平滚动条。 |
static int |
SCROLLBARS_HORIZONTAL_ONLY 只创建并显示水平滚动条。 |
static int |
SCROLLBARS_NONE 不为文本区创建或显示任何滚动条。 |
static int |
SCROLLBARS_VERTICAL_ONLY 只创建并显示垂直滚动条。 |
从类 java.awt.TextComponent 继承的字段 |
---|
textListener |
从类 java.awt.Component 继承的字段 |
---|
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
从接口 java.awt.image.ImageObserver 继承的字段 |
---|
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
构造方法摘要 | |
---|---|
TextArea() 构造一个将空字符串作为文本的新文本区。 |
|
TextArea(int rows, int columns) 构造一个新文本区,该文本区具有指定的行数和列数,并将空字符串作为文本。 |
|
TextArea(String text) 构造具有指定文本的新文本区。 |
|
TextArea(String text, int rows, int columns) 构造一个新文本区,该文本区具有指定的文本,以及指定的行数和列数。 |
|
TextArea(String text, int rows, int columns, int scrollbars) 构造一个新文本区,该文本区具有指定的文本,以及指定的行数、列数和滚动条可见性。 |
方法摘要 | |
---|---|
void |
addNotify() 创建 TextArea 的同位体。 |
void |
append(String str) 将给定文本追加到文本区的当前文本。 |
void |
appendText(String str) 已过时。 从 JDK version 1.1 开始,由 append(String) 取代。 |
AccessibleContext |
getAccessibleContext() 返回与此 TextArea 相关的 AccessibleContext 。 |
int |
getColumns() 返回此文本区中的列数。 |
Dimension |
getMinimumSize() 确定此文本区的最小大小。 |
Dimension |
getMinimumSize(int rows, int columns) 确定具有指定行数和列数的文本区的最小大小。 |
Dimension |
getPreferredSize() 确定此文本区的首选大小。 |
Dimension |
getPreferredSize(int rows, int columns) 确定具有指定行数和列数的文本区的首选大小。 |
int |
getRows() 返回此文本区的行数。 |
int |
getScrollbarVisibility() 返回指示文本区使用何种滚动条的枚举值。 |
void |
insert(String str, int pos) 在此文本区的指定位置插入指定文本。 |
void |
insertText(String str, int pos) 已过时。 从 JDK version 1.1 开始,由 insert(String, int) 取代。 |
Dimension |
minimumSize() 已过时。 从 JDK version 1.1 开始,由 getMinimumSize() 取代。 |
Dimension |
minimumSize(int rows, int columns) 已过时。 从 JDK version 1.1 开始,由 getMinimumSize(int, int) 取代。 |
protected String |
paramString() 返回表示此 TextArea 状态的字符串。 |
Dimension |
preferredSize() 已过时。 从 JDK version 1.1 开始,由 getPreferredSize() 取代。 |
Dimension |
preferredSize(int rows, int columns) 已过时。 从 JDK version 1.1 开始,由 getPreferredSize(int, int) 取代。 |
void |
replaceRange(String str, int start, int end) 用指定替换文本替换指定开始位置与结束位置之间的文本。 |
void |
replaceText(String str, int start, int end) 已过时。 从 JDK version 1.1 开始,由 replaceRange(String, int, int) 取代。 |
void |
setColumns(int columns) 设置此文本区的列数。 |
void |
setRows(int rows) 设置此文本区的行数。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
字段详细信息 |
---|
public static final int SCROLLBARS_BOTH
public static final int SCROLLBARS_VERTICAL_ONLY
public static final int SCROLLBARS_HORIZONTAL_ONLY
public static final int SCROLLBARS_NONE
构造方法详细信息 |
---|
public TextArea() throws HeadlessException
SCROLLBARS_BOTH
的情况下创建的,所以垂直滚动条和水平滚动条对于文本区都将是可视的。
HeadlessException
- 如果
GraphicsEnvironment.isHeadless
返回 true
GraphicsEnvironment.isHeadless()
public TextArea(String text) throws HeadlessException
SCROLLBARS_BOTH
的情况下创建的,所以垂直滚动条和水平滚动条对于文本区都将是可视的。
text
- 要显示的文本;如果
text
为
null
,则显示空字符串
""
HeadlessException
- 如果
GraphicsEnvironment.isHeadless
返回 true
GraphicsEnvironment.isHeadless()
public TextArea(int rows, int columns) throws HeadlessException
SCROLLBARS_BOTH
的情况下创建的,所以垂直滚动条和水平滚动条对于文本区都将是可视的。
rows
- 行数
columns
- 列数
HeadlessException
- 如果
GraphicsEnvironment.isHeadless
返回 true
GraphicsEnvironment.isHeadless()
public TextArea(String text, int rows, int columns) throws HeadlessException
SCROLLBARS_BOTH
的情况下创建的,所以垂直滚动条和水平滚动条对于文本区都将是可视的。
text
- 要显示的文本;如果
text
为
null
,则显示空字符串
""
rows
- 行数
columns
- 列数
HeadlessException
- 如果
GraphicsEnvironment.isHeadless
返回 true
GraphicsEnvironment.isHeadless()
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
GraphicsEnvironment.isHeadless()
方法详细信息 |
---|
public void addNotify()
TextArea
的同位体。该同位体允许修改
TextArea
的外观,而不更改其功能。
TextComponent
中的
addNotify
TextComponent.removeNotify()
public void insert(String str, int pos)
注意,传递 null
或不一致的参数是无效的,并且将导致不确定的行为。
str
- 要插入的非
null
文本
pos
- 插入的位置
TextComponent.setText(java.lang.String)
,
replaceRange(java.lang.String, int, int)
,
append(java.lang.String)
@Deprecated public void insertText(String str, int pos)
insert(String, int)
取代。
public void append(String str)
注意,传递 null
或不一致的参数是无效的,并且将导致不确定的行为。
str
- 要追加的非
null
文本
insert(java.lang.String, int)
@Deprecated public void appendText(String str)
append(String)
取代。
public void replaceRange(String str, int start, int end)
注意,传递 null
或不一致的参数是无效的,并且将导致不确定的行为。
str
- 用于替换的非
null
文本
start
- 开始位置
end
- 结束位置
insert(java.lang.String, int)
@Deprecated public void replaceText(String str, int start, int end)
replaceRange(String, int, int)
取代。
public int getRows()
setRows(int)
,
getColumns()
public void setRows(int rows)
rows
- 行数
IllegalArgumentException
- 如果为
rows
提供的值小于
0
getRows()
,
setColumns(int)
public int getColumns()
setColumns(int)
,
getRows()
public void setColumns(int columns)
columns
- 列数
IllegalArgumentException
- 如果为
columns
提供的值小于
0
getColumns()
,
setRows(int)
public int getScrollbarVisibility()
TextArea
类定义了四个整数常量,用来指定哪些滚动条是可用的。TextArea
有一个给出滚动条上的应用方向的构造方法。
SCROLLBARS_BOTH
,
SCROLLBARS_VERTICAL_ONLY
,
SCROLLBARS_HORIZONTAL_ONLY
,
SCROLLBARS_NONE
,
TextArea(java.lang.String, int, int, int)
public Dimension getPreferredSize(int rows, int columns)
rows
- 行数
columns
- 列数
Component.getPreferredSize()
@Deprecated public Dimension preferredSize(int rows, int columns)
getPreferredSize(int, int)
取代。
public Dimension getPreferredSize()
Component
中的
getPreferredSize
Component.getPreferredSize()
@Deprecated public Dimension preferredSize()
getPreferredSize()
取代。
Component
中的
preferredSize
public Dimension getMinimumSize(int rows, int columns)
rows
- 行数
columns
- 列数
Component.getMinimumSize()
@Deprecated public Dimension minimumSize(int rows, int columns)
getMinimumSize(int, int)
取代。
public Dimension getMinimumSize()
Component
中的
getMinimumSize
Component.getPreferredSize()
@Deprecated public Dimension minimumSize()
getMinimumSize()
取代。
Component
中的
minimumSize
protected String paramString()
TextArea
状态的字符串。此方法仅用于调试目的,对于各个实现,返回的字符串的内容和格式可能有所不同。返回的字符串可能为空,但不可能为
null
。
TextComponent
中的
paramString
public AccessibleContext getAccessibleContext()
TextArea
相关的
AccessibleContext
。对于文本区,
AccessibleContext
采用
AccessibleAWTTextArea
的形式。如有必要,可创建一个新的
AccessibleAWTTextArea
实例。
Accessible
中的
getAccessibleContext
TextComponent
中的
getAccessibleContext
TextArea
的
AccessibleContext
的
AccessibleAWTTextArea
|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。