©
本文档使用
php中文网手册 发布
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 | |||||||||
java.lang.Objectjava.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.awt.TextComponent 继承的方法 |
|---|
addTextListener, enableInputMethods, getBackground, getCaretPosition, getInputMethodRequests, getListeners, getSelectedText, getSelectionEnd, getSelectionStart, getText, getTextListeners, isEditable, processEvent, processTextEvent, removeNotify, removeTextListener, select, selectAll, setBackground, setCaretPosition, setEditable, setSelectionEnd, setSelectionStart, setText |
| 从类 java.awt.Component 继承的方法 |
|---|
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate |
| 从类 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 返回 trueGraphicsEnvironment.isHeadless()
public TextArea(String text)
throws HeadlessException
SCROLLBARS_BOTH 的情况下创建的,所以垂直滚动条和水平滚动条对于文本区都将是可视的。
text - 要显示的文本;如果 text 为 null,则显示空字符串 ""
HeadlessException - 如果 GraphicsEnvironment.isHeadless 返回 trueGraphicsEnvironment.isHeadless()
public TextArea(int rows,
int columns)
throws HeadlessException
SCROLLBARS_BOTH 的情况下创建的,所以垂直滚动条和水平滚动条对于文本区都将是可视的。
rows - 行数columns - 列数
HeadlessException - 如果 GraphicsEnvironment.isHeadless 返回 trueGraphicsEnvironment.isHeadless()
public TextArea(String text,
int rows,
int columns)
throws HeadlessException
SCROLLBARS_BOTH 的情况下创建的,所以垂直滚动条和水平滚动条对于文本区都将是可视的。
text - 要显示的文本;如果 text 为 null,则显示空字符串 ""rows - 行数columns - 列数
HeadlessException - 如果 GraphicsEnvironment.isHeadless 返回 trueGraphicsEnvironment.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 设置为 0columns - 列数;如果 columns 小于 0,则将 columns 设置为 0scrollbars - 确定为查看文本区创建的滚动条类型的常量
HeadlessException - 如果 GraphicsEnvironment.isHeadless 返回 trueGraphicsEnvironment.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 2 Platform Standard Ed. 6 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 | |||||||||
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。