模块 java.desktop

软件包 javax.swing.text

Class PlainDocument

java.lang.Object

javax.swing.text.AbstractDocument

javax.swing.text.PlainDocument

实现的所有接口

Serializable ， Document

public class PlainDocument
extends AbstractDocument

一个不保留字符属性的普通文档。 此文档的默认元素结构是文本中的行的映射。 getDefaultRootElement返回的Element是行的映射，每个子元素表示一行。 此模型不维护任何字符级别属性，但每行可以使用任意一组属性进行标记。 可以使用默认根元素快速执行到偏移的行和到行转换的偏移。 通过编辑触发的DocumentEvent的结构信息将指示行结构更改。

默认内容存储管理由间隙缓冲区实现（GapContent）执行。 它支持在编辑连续或聚集时以高效率编辑相当大的文档，这是典型的。

警告：此类的序列化对象与以后的Swing版本不兼容。 当前的序列化支持适用于运行相同版本Swing的应用程序之间的短期存储或RMI。 从1.4开始， java.beans软件包中添加了对所有JavaBeans java.beans长期存储的支持。 请参阅XMLEncoder 。

另请参见：

Document ， AbstractDocument ， Serialized Form

嵌套类汇总

嵌套类/接口声明在类 javax.swing.text.AbstractDocument

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

字段汇总

字段

变量和类型	字段	描述
static String	lineLimitAttribute	如果存在最大长度，则指定行的最大长度的属性的名称。
static String	tabSizeAttribute	指定内容中包含的选项卡的选项卡大小的属性的名称。

声明的属性在类 javax.swing.text.AbstractDocument

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

Fields declared in interface javax.swing.text.Document

StreamDescriptionProperty, TitleProperty

构造方法摘要

构造方法

构造器	描述
PlainDocument()	构造纯文本文档。
PlainDocument(AbstractDocument.Content c)	构造纯文本文档。

方法摘要

变量和类型	方法	描述
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)	作为文本删除的结果更新任何文档结构。

声明方法的类 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

声明方法的类 java.lang.Object

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

字段详细信息

tabSizeAttribute

public static final String tabSizeAttribute

指定内容中包含的选项卡的选项卡大小的属性的名称。 值的类型是Integer。

另请参见：

常数字段值

lineLimitAttribute

public static final String lineLimitAttribute

如果存在最大长度，则指定行的最大长度的属性的名称。 值的类型是Integer。

另请参见：

常数字段值

构造方法详细信息

PlainDocument

public PlainDocument()

构造纯文本文档。 构建并设置使用GapContent的默认模型。

PlainDocument

public PlainDocument(AbstractDocument.Content c)

构造纯文本文档。 将创建默认根元素，并将选项卡大小设置为8。

参数

c - 内容的容器

方法详细信息

insertString

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

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

虽然大多数Swing方法都不是，但这种方法是线程安全的。 有关更多信息，请参阅Concurrency in Swing 。

Specified by:

insertString在界面 Document

重写：

insertString在类 AbstractDocument

参数

offs - 起始偏移量> = 0

str - 要插入的字符串; null / empty字符串不执行任何操作

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 - 描述编辑的更改事件