- java.lang.Object
-
- java.awt.Component
-
- java.awt.TextComponent
-
- java.awt.TextArea
-
- All Implemented Interfaces:
-
ImageObserver
,MenuContainer
,Serializable
,Accessible
public class TextArea extends TextComponent
TextArea
对象是显示文本的多行区域。 它可以设置为允许编辑或只读。以下图像显示文本区域的外观:
此文本区域可以通过以下代码行创建:
new TextArea("Hello", 5, 40);
- 从以下版本开始:
- 1.0
- 另请参见:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class 描述 protected class
TextArea.AccessibleAWTTextArea
该类实现TextArea
类的可访问性支持。-
Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
-
Nested classes/interfaces inherited from class java.awt.TextComponent
TextComponent.AccessibleAWTTextComponent
-
-
Field Summary
Fields Modifier and Type Field 描述 static int
SCROLLBARS_BOTH
创建并显示垂直和水平滚动条。static int
SCROLLBARS_HORIZONTAL_ONLY
仅创建并显示水平滚动条。static int
SCROLLBARS_NONE
不要为文本区域创建或显示任何滚动条。static int
SCROLLBARS_VERTICAL_ONLY
仅创建并显示垂直滚动条。-
Fields inherited from class java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
-
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
-
Fields inherited from class java.awt.TextComponent
textListener
-
-
构造方法摘要
构造方法 Constructor 描述 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)
构造具有指定文本的新文本区域,并按照指定的行,列和滚动条可见性构造。
-
方法摘要
所有方法 接口方法 具体的方法 弃用的方法 Modifier and Type 方法 描述 void
addNotify()
创建TextArea
的同伴。void
append(String str)
将给定的文本附加到文本区域的当前文本。void
appendText(String str)
已过时。从JDK 1.1版开始,由append(String)
替代。AccessibleContext
getAccessibleContext()
返回AccessibleContext
与此相关TextArea
。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 1.1版开始,由insert(String, int)
替代。Dimension
minimumSize()
已过时。从JDK 1.1版开始,由getMinimumSize()
替代。Dimension
minimumSize(int rows, int columns)
已过时。从JDK 1.1版开始,由getMinimumSize(int, int)
替代。protected String
paramString()
返回表示TextArea
的状态的字符串。Dimension
preferredSize()
已过时。从JDK 1.1版开始,由getPreferredSize()
替代。Dimension
preferredSize(int rows, int columns)
已过时。从JDK 1.1版开始,由getPreferredSize(int, int)
替代。void
replaceRange(String str, int start, int end)
将指定的开始和结束位置之间的文本替换为指定的替换文本。void
replaceText(String str, int start, int end)
已过时。从JDK 1.1版开始,由replaceRange(String, int, int)
替代。void
setColumns(int columns)
设置此文本区域的列数。void
setRows(int rows)
设置此文本区域的行数。-
Methods inherited from class 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, 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, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setMixingCutoutShape, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from class 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
-
-
-
-
字段详细信息
-
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() throws HeadlessException
构造一个新的文本区域,空字符串作为文本。 此文本区域的创建滚动条可见度等于SCROLLBARS_BOTH
,因此此文本区域的垂直和水平滚动条都将可见。- 异常
-
HeadlessException
- 如果GraphicsEnvironment.isHeadless
返回true - 另请参见:
-
GraphicsEnvironment.isHeadless()
-
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
- 参数
-
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()
-
-
-
方法详细信息
-
addNotify
public void addNotify()
创建TextArea
的同伴。 对等体允许我们修改TextArea
的外观,而不改变它的任何功能。- 重写:
-
addNotify
在TextComponent
- 另请参见:
-
TextComponent.removeNotify()
-
insert
public void insert(String str, int pos)
在此文本区域的指定位置插入指定的文本。请注意,通过
null
或参数不一致将导致未指定的行为。- 参数
-
str
- 要插入的非null
文本 -
pos
- 要插入的位置 - 从以下版本开始:
- 1.1
- 另请参见:
-
TextComponent.setText(java.lang.String)
,replaceRange(java.lang.String, int, int)
,append(java.lang.String)
-
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)
-
getScrollbarVisibility
public int getScrollbarVisibility()
返回枚举值,指示文本区域使用的滚动条。TextArea
类定义了四个整数常量,用于指定哪些滚动条可用。TextArea
具有一个构造函数,可以在滚动条上给出应用程序的权限。- 结果
- 一个指示使用哪个滚动条的整数
- 从以下版本开始:
- 1.1
- 另请参见:
-
SCROLLBARS_BOTH
,SCROLLBARS_VERTICAL_ONLY
,SCROLLBARS_HORIZONTAL_ONLY
,SCROLLBARS_NONE
,TextArea(java.lang.String, int, int, 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
- 列数 - 结果
- 文本区域所需的首选尺寸
-
getPreferredSize
public Dimension getPreferredSize()
确定此文本区域的首选大小。- 重写:
-
getPreferredSize
在Component
- 结果
- 此文本区域所需的首选尺寸
- 从以下版本开始:
- 1.1
- 另请参见:
-
Component.getPreferredSize()
-
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
- 列数 - 结果
- 文本区域的最小大小
-
getMinimumSize
public Dimension getMinimumSize()
确定此文本区域的最小大小。- 重写:
-
getMinimumSize
在Component
- 结果
- 此文本区域所需的首选尺寸
- 从以下版本开始:
- 1.1
- 另请参见:
-
Component.getPreferredSize()
-
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
-
-