javax.swing.text

Class PlainDocument

java.lang.Object

javax.swing.text.AbstractDocument

javax.swing.text.PlainDocument

All Implemented Interfaces:

Serializable， Document

public class PlainDocument
extends AbstractDocument

保持没有字符属性的普通文档。此文档的默认元素结构是文本中的行的映射。通过getdefaultrootelement返回的元素是Map上的线条，和每个子元素代表一行。此模型不维护任何字符级别的属性，但每行可以用任意一组属性标记。可以使用默认根元素快速地对行进行偏移，并可以快速地进行偏移。结构信息的documentevent的被编辑将指示线结构的变化。

默认的内容存储管理是由一个间隙缓冲的实现进行（gapcontent）。它支持编辑相当大的文件，具有良好的效率时，编辑是连续的或聚集，是典型的。

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

另请参见：

Document， AbstractDocument

Nested Class Summary

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

AbstractDocument.AbstractElement, AbstractDocument.AttributeContext, AbstractDocument.BranchElement, AbstractDocument.Content, AbstractDocument.DefaultDocumentEvent, AbstractDocument.ElementEdit, AbstractDocument.LeafElement

Field Summary

Fields

Modifier and Type	Field and Description
static String	lineLimitAttribute 指定行的最大长度的属性的名称，如果有一个最大长度。
static String	tabSizeAttribute 指定包含在内容中的制表符的制表符大小的属性的名称。

Fields inherited from class javax.swing.text.AbstractDocument

BAD_LOCATION, BidiElementName, ContentElementName, ElementNameAttribute, listenerList, ParagraphElementName, SectionElementName

Fields inherited from interface javax.swing.text.Document

StreamDescriptionProperty, TitleProperty

构造方法摘要

构造方法

Constructor and Description
PlainDocument() 构建一个纯文本文档。
PlainDocument(AbstractDocument.Content c) 构建一个纯文本文档。

方法摘要

Modifier and Type	Method and Description
protected AbstractDocument.AbstractElement	createDefaultRoot() 创建用于表示默认文档结构的根元素。
Element	getDefaultRootElement() 获取文档模型的默认根元素。
Element	getParagraphElement(int pos) 获取包含给定位置的段落元素。
void	insertString(int offs, String str, AttributeSet a) 在文档中插入一些内容。
protected void	insertUpdate(AbstractDocument.DefaultDocumentEvent chng, AttributeSet attr) 更新文本插入的结果文档结构。
protected void	removeUpdate(AbstractDocument.DefaultDocumentEvent chng) 更新任何文档结构作为文本移除的结果。

Methods inherited from class javax.swing.text.AbstractDocument

addDocumentListener, addUndoableEditListener, createBranchElement, createLeafElement, createPosition, dump, fireChangedUpdate, fireInsertUpdate, fireRemoveUpdate, fireUndoableEditUpdate, getAsynchronousLoadPriority, getAttributeContext, getBidiRootElement, getContent, getCurrentWriter, getDocumentFilter, getDocumentListeners, getDocumentProperties, getEndPosition, getLength, getListeners, getProperty, getRootElements, getStartPosition, getText, getText, getUndoableEditListeners, postRemoveUpdate, putProperty, readLock, readUnlock, remove, removeDocumentListener, removeUndoableEditListener, render, replace, setAsynchronousLoadPriority, setDocumentFilter, setDocumentProperties, writeLock, writeUnlock

Methods inherited from class java.lang.Object

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

Field Detail

tabSizeAttribute

public static final String tabSizeAttribute

指定包含在内容中的制表符的制表符大小的属性的名称。值的类型为整数。

另请参见：

Constant Field Values

lineLimitAttribute

public static final String lineLimitAttribute

指定行的最大长度的属性的名称，如果有一个最大长度。值的类型为整数。

另请参见：

Constant Field Values

Constructor Detail

PlainDocument

public PlainDocument()

构建一个纯文本文档。使用 GapContent默认模型的构建和设置。

PlainDocument

public PlainDocument(AbstractDocument.Content c)

构建一个纯文本文档。创建一个默认的根元素，并将标签大小设置为8。

参数

c为内容的容器

方法详细信息

insertString

public void insertString(int offs,
                         String str,
                         AttributeSet a)
                  throws BadLocationException

在文档中插入一些内容。插入内容会导致在实际发生更改时保持写锁，然后通知观察者在抓取写锁的线程上进行通知。

这种方法是线程安全的，虽然大多数摇摆方法不是。更多信息请见Concurrency in Swing。

Specified by:

insertString 接口 Document

重写：

insertString 方法重写，继承类 AbstractDocument

参数

offs -起始偏移> = 0

str -插入字符串；空/空字符串没有

a -插入内容的属性

异常

BadLocationException -给定的插入位置不在有效的文档位置

另请参见：

Document.insertString(int, java.lang.String, javax.swing.text.AttributeSet)

getDefaultRootElement

public Element getDefaultRootElement()

获取文档模型的默认根元素。

Specified by:

getDefaultRootElement 接口 Document

Specified by:

getDefaultRootElement 方法重写，继承类 AbstractDocument

结果

根

另请参见：

Document.getDefaultRootElement()

createDefaultRoot

protected AbstractDocument.AbstractElement createDefaultRoot()

创建用于表示默认文档结构的根元素。

结果

的元件库

getParagraphElement

public Element getParagraphElement(int pos)

获取包含给定位置的段落元素。由于本文档只模型行，它返回行，而不是。

Specified by:

getParagraphElement 方法重写，继承类 AbstractDocument

参数

pos -起始偏移> = 0

结果

元素

insertUpdate

protected void insertUpdate(AbstractDocument.DefaultDocumentEvent chng,
                            AttributeSet attr)

更新文本插入的结果文档结构。这将发生在一个写锁。由于本文档只简单地绘制出行，我们刷新了线图。

重写：

insertUpdate 方法重写，继承类 AbstractDocument

参数

chng描述DIT更改事件

attr -用于插入的文本属性的设置

removeUpdate

protected void removeUpdate(AbstractDocument.DefaultDocumentEvent chng)

更新任何文档结构作为文本移除的结果。这将发生在一个写锁。由于该结构代表一个行映射，这只是检查，看看是否删除跨越线条。如果它，两行以外的移除区域被连接在一起。

重写：

removeUpdate 方法重写，继承类 AbstractDocument

参数

chng描述编辑更改事件