javax.swing

Class JTextArea

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.text.JTextComponent

javax.swing.JTextArea

All Implemented Interfaces:

ImageObserver， MenuContainer， Serializable， Accessible， Scrollable

public class JTextArea
extends JTextComponent

一个 JTextArea是多线区域显示文本。它是一个轻量级的组件，提供源代码的兼容性与 java.awt.TextArea班，它可以合理地做。你可以找到使用 Using Text Components所有文本组件的信息和例子，java教程中的一部分。

该组件已在java.awt.TextArea类没有发现能力。父类应该对额外功能咨询。选择多行文本类的更多的能力和JEditorPane JTextPane。

内部处理的java.awt.TextArea滚动。JTextArea是不同的，它并不管理滚动，但实现摆动Scrollable接口。这使得它可以被放置在一个JScrollPane如果滚动行为的需要，并直接使用如果滚动不理想。

的java.awt.TextArea要换行的能力。这是由水平滚动策略控制的。由于滚动不由JTextArea直接向后兼容性必须提供另一种方式。JTextArea已绑定属性为换行控制是否换行。默认情况下，行包装属性设置为假（不包）。

java.awt.TextArea有两个属性rows和columns是用来确定首选的大小。JTextArea利用这些性质说明首选大小的视口时，放在一个JScrollPane匹配java.awt.TextArea提供的功能。JTextArea有什么是需要显示的文本的所有首选的尺寸，使其功能正常，在一JScrollPane。如果rows或columns价值等于零，沿轴用于视口首选大小沿同一轴线的首选尺寸。

的java.awt.TextArea可以监测变化增加了TextListener为TextEvents。在基于组件的JTextComponent，改变广播模型通过对DocumentListeners DocumentEvent。的DocumentEvent给出和变化的一种变化的位置，如果需要的话。代码片段可能看起来像是：

所有DocumentListener mylistener =？？；文本区myarea =？？；myarea。getdocument() adddocumentlistener（mylistener）；

换行符

对于如何处理一个换行符的讨论，看 DefaultEditorKit。

警告： Swing是线程不安全的。更多信息见Swing's Threading Policy。

警告：序列化该类的对象与以后的Swing版本不兼容。当前的序列化支持适用于短期贮藏或RMI运行相同Swing版本的应用程序之间。为1.4，为所有JavaBeans™长期存储的支持已被添加到java.beans包。请看XMLEncoder。

另请参见：

JTextPane， JEditorPane

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	JTextArea.AccessibleJTextArea 这个类实现了对 JTextArea类可访问性支持。

Nested classes/interfaces inherited from class javax.swing.text.JTextComponent

JTextComponent.AccessibleJTextComponent, JTextComponent.DropLocation, JTextComponent.KeyBinding

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields inherited from class javax.swing.text.JTextComponent

DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

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

构造方法摘要

构造方法

Constructor and Description
JTextArea() 构建了一种新的文本。
JTextArea(Document doc) 构建了一种新的文本区与给定的文档模型，和所有其他参数默认值（null，0，0）。
JTextArea(Document doc, String text, int rows, int columns) 构建与指定的行数和列数的一个新的文本区，和给定的模型。
JTextArea(int rows, int columns) 构建了一个新的空文本与指定的行数和列数。
JTextArea(String text) 构建具有指定文本显示新文本。
JTextArea(String text, int rows, int columns) 构建具有指定文本和行数和列数的新文本。

方法摘要

Modifier and Type	Method and Description
void	append(String str) 将给定的文本文件的结尾。
protected Document	createDefaultModel() 创建的模型的默认实现，如果一个没有明确给出，在建设中使用的模型。
AccessibleContext	getAccessibleContext() 获取与此相关的accessiblecontext JTextArea。
int	getColumns() 返回textarea的列数。
protected int	getColumnWidth() 获取列宽度。
int	getLineCount() 确定该区域中包含的行数。
int	getLineEndOffset(int line) 确定给定行的结束的偏移量。
int	getLineOfOffset(int offset) 将一个偏移量转换成一个行数的偏移量。
int	getLineStartOffset(int line) 确定给定行的起始偏移量的偏移量。
boolean	getLineWrap() 获取文本区域的行包装策略。
Dimension	getPreferredScrollableViewportSize() 返回视图的首选大小如果该组件被嵌入在一个JScrollPane。
Dimension	getPreferredSize() 返回textarea首选大小。
protected int	getRowHeight() 定义行的高度的意义。
int	getRows() 返回在文本行数。
boolean	getScrollableTracksViewportWidth() 如果一个视图中应力本可滚动的宽度到视口的宽度匹配，返回true。
int	getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction) 显示逻辑行或列的组件应该计算将完全暴露一个新的行或列的滚动增量，这取决于方向的值。
int	getTabSize() 获取用于展开制表符的字符数。
String	getUIClassID() 返回用户界面的类标识。
boolean	getWrapStyleWord() 获取文本区域是否为包装线的包装样式。
void	insert(String str, int pos) 在指定位置插入指定的文本。
protected String	paramString() 返回JTextArea的字符串表示。
void	replaceRange(String str, int start, int end) 用指定的新文本替换所指示的开始到结束位置的文本。
void	setColumns(int columns) 设置该文本框的列数。
void	setFont(Font f) 设置当前字体。
void	setLineWrap(boolean wrap) 设置文本区域的行包装策略。
void	setRows(int rows) 设置此文本的行数。
void	setTabSize(int size) 设置字符集的数量，以扩大标签。
void	setWrapStyleWord(boolean word) 设置文本区为包装线时使用的包装样式。

Methods inherited from class javax.swing.text.JTextComponent

addCaretListener, addInputMethodListener, addKeymap, copy, cut, fireCaretUpdate, getActions, getCaret, getCaretColor, getCaretListeners, getCaretPosition, getDisabledTextColor, getDocument, getDragEnabled, getDropLocation, getDropMode, getFocusAccelerator, getHighlighter, getInputMethodRequests, getKeymap, getKeymap, getMargin, getNavigationFilter, getPrintable, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getSelectedText, getSelectedTextColor, getSelectionColor, getSelectionEnd, getSelectionStart, getText, getText, getToolTipText, getUI, isEditable, loadKeymap, modelToView, moveCaretPosition, paste, print, print, print, processInputMethodEvent, read, removeCaretListener, removeKeymap, removeNotify, replaceSelection, restoreComposedText, saveComposedText, select, selectAll, setCaret, setCaretColor, setCaretPosition, setComponentOrientation, setDisabledTextColor, setDocument, setDragEnabled, setDropMode, setEditable, setFocusAccelerator, setHighlighter, setKeymap, setMargin, setNavigationFilter, setSelectedTextColor, setSelectionColor, setSelectionEnd, setSelectionStart, setText, setUI, updateUI, viewToModel, write

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

JTextArea

public JTextArea()

构建了一种新的文本。设置一个默认模型，初始字符串为空，行/列设置为0。

JTextArea

public JTextArea(String text)

构建具有指定文本显示新文本。创建一个默认模型，并将行/列设置为0。

参数

text -要显示的文本，或空

JTextArea

public JTextArea(int rows,
                 int columns)

构建了一个新的空文本与指定的行数和列数。创建了一个默认模型，并且初始字符串为空。

参数

rows -行> = 0号

columns -列> = 0号

异常

IllegalArgumentException如果行或列的观点是消极的。

JTextArea

public JTextArea(String text,
                 int rows,
                 int columns)

构建具有指定文本和行数和列数的新文本。创建了一个默认模型。

参数

text -要显示的文本，或空

rows -行> = 0号

columns -列> = 0号

异常

IllegalArgumentException如果行或列的观点是消极的。

JTextArea

public JTextArea(Document doc)

构建了一种新的文本区与给定的文档模型，和所有其他参数默认值（null，0，0）。

参数

doc -模型的使用

JTextArea

public JTextArea(Document doc,
                 String text,
                 int rows,
                 int columns)

构建与指定的行数和列数的一个新的文本区，和给定的模型。所有的构造函数都通过这个构造函数来喂养。

参数

doc -使用模式，或创建一个默认如果空

text -要显示的文本，如果没有返回null

rows -行> = 0号

columns -列> = 0号

异常

IllegalArgumentException如果行或列的观点是消极的。

方法详细信息

getUIClassID

public String getUIClassID()

返回用户界面的类标识。

重写：

getUIClassID 方法重写，继承类 JComponent

结果

ID（“textareaui”）

另请参见：

JComponent.getUIClassID()， UIDefaults.getUI(javax.swing.JComponent)

createDefaultModel

protected Document createDefaultModel()

创建的模型的默认实现，如果一个没有明确给出，在建设中使用的模型。一个新的plaindocument返回实例。

结果

默认文档模型

setTabSize

public void setTabSize(int size)

设置字符集的数量，以扩大标签。这将乘以可变宽度字体的最大值。一个propertychange事件（“tabsize”）被激发时，标签的大小变化。

参数

size -字符数扩大到

另请参见：

getTabSize()

getTabSize

public int getTabSize()

获取用于展开制表符的字符数。如果文档是空的或没有一个标签设置，返回一个默认的8。

结果

字符数

setLineWrap

public void setLineWrap(boolean wrap)

设置文本区域的行包装策略。如果设置为真的行将被包装，如果他们太长，以适应在分配的宽度。如果设置为false，线总是会打开。一个 PropertyChange事件（“linewrap”）是因政策变化。默认情况下，这个属性是假的。

参数

wrap -表示如果线应包

另请参见：

getLineWrap()

getLineWrap

public boolean getLineWrap()

获取文本区域的行包装策略。如果设置为真的行将被包装，如果他们太长，以适应在分配的宽度。如果设置为false，线总是会打开。

结果

如果线条将被包裹

setWrapStyleWord

public void setWrapStyleWord(boolean word)

设置文本区为包装线时使用的包装样式。如果设置为true，将线条在字边界包（空格）如果他们太长适合分配宽度内。如果设置为假，则行将被包裹在字符边界。默认情况下，这个属性是假的。

参数

word -表示如果单词边界应该用于换行

另请参见：

getWrapStyleWord()

getWrapStyleWord

public boolean getWrapStyleWord()

获取文本区域是否为包装线的包装样式。如果设置为true，将线条在字边界包（即空格）如果他们太长适合分配宽度内。如果设置为假，则行将被包裹在字符边界。

结果

如果包装样式应该是字边界而不是字符边界

另请参见：

setWrapStyleWord(boolean)

getLineOfOffset

public int getLineOfOffset(int offset)
                    throws BadLocationException

将一个偏移量转换成一个行数的偏移量。

参数

offset -偏移> = 0

结果

行数> = 0

异常

BadLocationException -扔如果偏移小于零或大于文件长度。

getLineCount

public int getLineCount()

确定该区域中包含的行数。

结果

行数> 0

getLineStartOffset

public int getLineStartOffset(int line)
                       throws BadLocationException

确定给定行的起始偏移量的偏移量。

参数

line -线数翻译> = 0

结果

偏移量> = 0

异常

BadLocationException如果线小于零或大于或等于文件中的行数抛（据getlinecount）。

getLineEndOffset

public int getLineEndOffset(int line)
                     throws BadLocationException

确定给定行的结束的偏移量。

参数

line -线> = 0

结果

偏移量> = 0

异常

BadLocationException如果线小于零或大于或等于文件中的行数抛（据getlinecount）。

insert

public void insert(String str,
                   int pos)

在指定位置插入指定的文本。如果该模型为空，或如果文本为空或空，则什么都不做。

参数

str -插入文本

pos -在该位置插入> = 0

异常

IllegalArgumentException如果POS模型中一个无效的位置

另请参见：

TextComponent.setText(java.lang.String)， replaceRange(java.lang.String, int, int)

append

public void append(String str)

将给定的文本文件的结尾。如果该模型为空或字符串为空或空，则什么都不做。

参数

str -插入文本

另请参见：

insert(java.lang.String, int)

replaceRange

public void replaceRange(String str,
                         int start,
                         int end)

用指定的新文本替换所指示的开始到结束位置的文本。如果模型是无效的，则什么都不做。只做一个删除，如果新的字符串是空的或空的。

参数

str -使用替换文本

start -起始位置> = 0

end -末端位置> =开始

异常

IllegalArgumentException如果范围的一部分，是模型中的一个无效的位置

另请参见：

insert(java.lang.String, int)， replaceRange(java.lang.String, int, int)

getRows

public int getRows()

返回在文本行数。

结果

行数> = 0

setRows

public void setRows(int rows)

设置此文本的行数。电话invalidate()设置新值后。

参数

rows -行> = 0号

异常

IllegalArgumentException如果排小于0

另请参见：

getRows()

getRowHeight

protected int getRowHeight()

定义行的高度的意义。此默认为字体的高度。

结果

高度> = 1

getColumns

public int getColumns()

返回textarea的列数。

结果

列数> = 0

setColumns

public void setColumns(int columns)

设置该文本框的列数。没有一个invalidate()设置新值后。

参数

columns -列> = 0号

异常

IllegalArgumentException如果柱小于0

另请参见：

getColumns()

getColumnWidth

protected int getColumnWidth()

获取列宽度。什么是列的含义可以被认为是一个相当弱的概念，一些字体。此方法用于定义列的宽度。默认情况下，这被定义为使用的字体的字符M的宽度。这种方法可以被重新定义为一些替代量。

结果

列宽度> = 1

getPreferredSize

public Dimension getPreferredSize()

返回textarea首选大小。这是需要显示的文本和要求视口的大小的最大值。

重写：

getPreferredSize 方法重写，继承类 JComponent

结果

的大小

另请参见：

JComponent.setPreferredSize(java.awt.Dimension)， ComponentUI

setFont

public void setFont(Font f)

设置当前字体。这将删除缓存的行高和列宽这样新的字体将反映，并要求revalidate()。

重写：

setFont 方法重写，继承类 JComponent

参数

f -字体使用当前字体

另请参见：

Component.getFont()

paramString

protected String paramString()

返回JTextArea的字符串表示。此方法仅用于调试目的，返回的字符串的内容和格式可能会在实现过程中有所不同。返回的字符串是空的但可能不 null。

重写：

paramString 方法重写，继承类 JTextComponent

结果

这个JTextArea的字符串表示。

getScrollableTracksViewportWidth

public boolean getScrollableTracksViewportWidth()

如果一个视图中应力本可滚动的宽度到视口的宽度匹配，返回true。这是实现返回的真实，如果行包装政策是真的，和假如果线没有被包裹。

Specified by:

getScrollableTracksViewportWidth 接口 Scrollable

重写：

getScrollableTracksViewportWidth 方法重写，继承类 JTextComponent

结果

如果视应力scrollables宽度匹配自己的。

getPreferredScrollableViewportSize

public Dimension getPreferredScrollableViewportSize()

返回视图的首选大小如果该组件被嵌入在一个JScrollPane。这种使用所需的行和列的设置是否已设置，否则使用父类的行为。

Specified by:

getPreferredScrollableViewportSize 接口 Scrollable

重写：

getPreferredScrollableViewportSize 方法重写，继承类 JTextComponent

结果

一个jviewport的观点是可滚动的preferredsize。

另请参见：

JComponent.getPreferredSize()

getScrollableUnitIncrement

public int getScrollableUnitIncrement(Rectangle visibleRect,
                                      int orientation,
                                      int direction)

显示逻辑行或列的组件应该计算将完全暴露一个新的行或列的滚动增量，这取决于方向的值。这是实现使用价值的 getRowHeight和 getColumnWidth方法返回。

滚动的容器，如滚动窗格，将使用此方法每次用户请求一个单元滚动。

Specified by:

getScrollableUnitIncrement 接口 Scrollable

重写：

getScrollableUnitIncrement 方法重写，继承类 JTextComponent

参数

visibleRect -视图的视口内的可见区域

orientation - swingconstants.vertical或swingconstants.horizontal。

direction -小于零的滚动/左，大于零的下/右。

结果

用于在指定方向上滚动的“单位”增量

异常

一个无效的方向 IllegalArgumentException -

另请参见：

JScrollBar.setUnitIncrement(int)， getRowHeight()， getColumnWidth()

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取与此相关的accessiblecontext JTextArea。JTextAreas的accessiblecontext以一个accessiblejtextarea形式。一个新的accessiblejtextarea实例被创建时。

Specified by:

getAccessibleContext 接口 Accessible

重写：

getAccessibleContext 方法重写，继承类 JTextComponent

结果

一个accessiblejtextarea作为JTextArea的accessiblecontext