JavaTM 2 Platform
Standard Ed. 5.0

javax.swing.text
类 DefaultStyledDocument

java.lang.Object
  继承者 javax.swing.text.AbstractDocument
      继承者 javax.swing.text.DefaultStyledDocument
所有已实现的接口:
Serializable, Document, StyledDocument
直接已知子类:
HTMLDocument

public class DefaultStyledDocument
extends AbstractDocument
implements StyledDocument

能够以类似富文本格式 (Rich Text Format) 的方式对其字符和段落样式进行标记的文档。此文档的元素结构表示样式在运行时的相互引用。这些样式运行被映射到段落元素结构(也有可能以其他结构形式驻留)。样式运行在段落边界处中断,原因是段落边界被指派了逻辑样式。

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

另请参见:
Document, AbstractDocument

嵌套类摘要
static class DefaultStyledDocument.AttributeUndoableEdit
          用于记住 AttributeSet 对 Element 更改的一个 UndoableEdit。
 class DefaultStyledDocument.ElementBuffer
          管理对元素层次结构更改的类。
static class DefaultStyledDocument.ElementSpec
          构建元素的规范。
protected  class DefaultStyledDocument.SectionElement
          文档的默认根元素... 与所包含的段落/行对应。
 
从类 javax.swing.text.AbstractDocument 继承的嵌套类/接口
AbstractDocument.AbstractElement, AbstractDocument.AttributeContext, AbstractDocument.BranchElement, AbstractDocument.Content, AbstractDocument.DefaultDocumentEvent, AbstractDocument.ElementEdit, AbstractDocument.LeafElement
 
字段摘要
protected  DefaultStyledDocument.ElementBuffer buffer
           
static int BUFFER_SIZE_DEFAULT
          初始内容缓冲区的默认大小。
 
从类 javax.swing.text.AbstractDocument 继承的字段
BAD_LOCATION, BidiElementName, ContentElementName, ElementNameAttribute, listenerList, ParagraphElementName, SectionElementName
 
从接口 javax.swing.text.Document 继承的字段
StreamDescriptionProperty, TitleProperty
 
构造方法摘要
DefaultStyledDocument()
          构造默认的样式化文档。
DefaultStyledDocument(AbstractDocument.Content c, StyleContext styles)
          构造样式化文档。
DefaultStyledDocument(StyleContext styles)
          构造具有默认的内容存储实现和一组共享样式的样式化文档。
 
方法摘要
 void addDocumentListener(DocumentListener listener)
          添加负责通知任何更改的文档侦听器。
 Style addStyle(String nm, Style parent)
          向逻辑样式层次结构中添加新样式。
protected  void create(DefaultStyledDocument.ElementSpec[] data)
          初始化文档,以反映给定元素结构(即由 getDefaultRootElement 方法报告的结构)。
protected  AbstractDocument.AbstractElement createDefaultRoot()
          创建用于代表默认文档结构的根元素。
 Color getBackground(AttributeSet attr)
          从属性集获得背景颜色。
 Element getCharacterElement(int pos)
          获得基于某个位置的字符元素。
 Element getDefaultRootElement()
          获得默认的根元素。
 Font getFont(AttributeSet attr)
          从属性集获得字体。
 Color getForeground(AttributeSet attr)
          从属性集获得前景色。
 Style getLogicalStyle(int p)
          获取表示给定位置处分配给段落的逻辑样式。
 Element getParagraphElement(int pos)
          获得位于偏移量 pos 的段落元素。
 Style getStyle(String nm)
          获取以前添加的已命名的样式。
 Enumeration<?> getStyleNames()
          获取样式名称列表。
protected  void insert(int offset, DefaultStyledDocument.ElementSpec[] data)
          批量插入新元素。
protected  void insertUpdate(AbstractDocument.DefaultDocumentEvent chng, AttributeSet attr)
          在文本插入后更新文档结构。
 void removeDocumentListener(DocumentListener listener)
          移除文档侦听器。
 void removeStyle(String nm)
          移除以前添加到文档中的已命名样式。
protected  void removeUpdate(AbstractDocument.DefaultDocumentEvent chng)
          在文本移除后更新文档结构。
 void setCharacterAttributes(int offset, int length, AttributeSet s, boolean replace)
          为文档某些部分设置属性。
 void setLogicalStyle(int pos, Style s)
          设置给定位置处用于段落的逻辑样式。
 void setParagraphAttributes(int offset, int length, AttributeSet s, boolean replace)
          设置段落属性。
protected  void styleChanged(Style style)
          此文档样式有任何改变时调用。
 
从类 javax.swing.text.AbstractDocument 继承的方法
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, insertString, postRemoveUpdate, putProperty, readLock, readUnlock, remove, removeUndoableEditListener, render, replace, setAsynchronousLoadPriority, setDocumentFilter, setDocumentProperties, writeLock, writeUnlock
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
从接口 javax.swing.text.Document 继承的方法
addUndoableEditListener, createPosition, getEndPosition, getLength, getProperty, getRootElements, getStartPosition, getText, getText, insertString, putProperty, remove, removeUndoableEditListener, render
 

字段详细信息

BUFFER_SIZE_DEFAULT

public static final int BUFFER_SIZE_DEFAULT
初始内容缓冲区的默认大小。

另请参见:
常量字段值

buffer

protected DefaultStyledDocument.ElementBuffer buffer
构造方法详细信息

DefaultStyledDocument

public DefaultStyledDocument(AbstractDocument.Content c,
                             StyleContext styles)
构造样式化文档。

参数:
c - 内容容器
styles - 可跨文档共享的资源和样式定义

DefaultStyledDocument

public DefaultStyledDocument(StyleContext styles)
构造具有默认的内容存储实现和一组共享样式的样式化文档。

参数:
styles - 样式

DefaultStyledDocument

public DefaultStyledDocument()
构造默认的样式化文档。此缓冲区输入内容大小为 BUFFER_SIZE_DEFAULT 并有一个由文档的生命周期确定其范围且不与其他文档共享的样式上下文。

方法详细信息

getDefaultRootElement

public Element getDefaultRootElement()
获得默认的根元素。

指定者:
接口 Document 中的 getDefaultRootElement
指定者:
AbstractDocument 中的 getDefaultRootElement
返回:
另请参见:
Document.getDefaultRootElement()

create

protected void create(DefaultStyledDocument.ElementSpec[] data)
初始化文档,以反映给定元素结构(即由 getDefaultRootElement 方法报告的结构)。如果该文档包含了任何数据,将首先移除这些数据。


insert

protected void insert(int offset,
                      DefaultStyledDocument.ElementSpec[] data)
               throws BadLocationException
批量插入新元素。这有助于在取消锁定状态下对文档进行解析并为元素结构修改做准备。此方法使用一个描述如何更新元素结构的标记数组,这样在异步更新的情况下写锁定的时间得到显著降低。

虽然大多数 Swing 方法不是线程安全的,但此方法是线程安全的。有关更多信息,请参阅 Threads and Swing

参数:
offset - 起始偏移量,该偏移量 >= 0
data - 元素数据
抛出:
BadLocationException - 无效的起始偏移量

addStyle

public Style addStyle(String nm,
                      Style parent)
向逻辑样式层次结构中添加新样式。样式属性自下向上进行解析,所以在子级中指定的属性将重写父级中指定的属性。

指定者:
接口 StyledDocument 中的 addStyle
参数:
nm - 样式的名称(在命名样式集合中必须是惟一的)。如果样式未命名,则此名称可能为 null,但是调用方要负责管理返回的引用,因为未命名的样式不能通过其名称获取。未命名的样式可以用于诸如字符属性重写这样的情况(例如在样式运行中)。
parent - 父样式。如果未指定的属性不需要以其他样式解析,则此值可以为 null。
返回:
样式

removeStyle

public void removeStyle(String nm)
移除以前添加到文档中的已命名样式。

指定者:
接口 StyledDocument 中的 removeStyle
参数:
nm - 要移除的样式的名称

getStyle

public Style getStyle(String nm)
获取以前添加的已命名的样式。

指定者:
接口 StyledDocument 中的 getStyle
参数:
nm - 样式名称
返回:
样式

getStyleNames

public Enumeration<?> getStyleNames()
获取样式名称列表。

返回:
所有样式名称

setLogicalStyle

public void setLogicalStyle(int pos,
                            Style s)
设置给定位置处用于段落的逻辑样式。如果没有为字符和段落属性显式设置属性,则它们将通过分配到段落的逻辑样式进行解析,也就是通过某个层次结构来解析,这些层次结构完全独立于文档中元素的层次结构。

虽然大多数 Swing 方法不是线程安全的,但此方法是线程安全的。有关更多信息,请参阅 Threads and Swing

指定者:
接口 StyledDocument 中的 setLogicalStyle
参数:
pos - 文档开始处的偏移量,该偏移量 >= 0
s - 要分配给段落的逻辑样式,如果没有,则为 null

getLogicalStyle

public Style getLogicalStyle(int p)
获取表示给定位置处分配给段落的逻辑样式。

指定者:
接口 StyledDocument 中的 getLogicalStyle
参数:
p - 要转换为段落的位置和确定逻辑样式要分配到的位置,该值 >= 0。这是文档开始处的偏移量。
返回:
样式,如果没有,则为 null

setCharacterAttributes

public void setCharacterAttributes(int offset,
                                   int length,
                                   AttributeSet s,
                                   boolean replace)
为文档某些部分设置属性。进行更改的过程中由此操作保持写锁定,并在更改成功完成后向侦听器发送一个 DocumentEvent。

虽然大多数 Swing 方法不是线程安全的,但此方法是线程安全的。有关更多信息,请参阅 Threads and Swing

指定者:
接口 StyledDocument 中的 setCharacterAttributes
参数:
offset - 文档中的偏移量,该偏移量 >= 0
length - 长度,该长度 >= 0
s - 属性
replace - 如果应在设置新属性之前替换原来的属性,则为 true

setParagraphAttributes

public void setParagraphAttributes(int offset,
                                   int length,
                                   AttributeSet s,
                                   boolean replace)
设置段落属性。

虽然大多数 Swing 方法不是线程安全的,但此方法是线程安全的。有关更多信息,请参阅 Threads and Swing

指定者:
接口 StyledDocument 中的 setParagraphAttributes
参数:
offset - 段落偏移量,该偏移量 >= 0
length - 所影响的字符数,该字符数 >= 0
s - 属性
replace - 确定是替换现有属性还是合并现有属性

getParagraphElement

public Element getParagraphElement(int pos)
获得位于偏移量 pos 的段落元素。一个段落至少要包含一个子 Element,它通常为叶元素。

指定者:
接口 StyledDocument 中的 getParagraphElement
指定者:
AbstractDocument 中的 getParagraphElement
参数:
pos - 起始偏移量,该偏移量 >= 0
返回:
元素

getCharacterElement

public Element getCharacterElement(int pos)
获得基于某个位置的字符元素。

指定者:
接口 StyledDocument 中的 getCharacterElement
参数:
pos - 文档中的位置,该位置 >= 0
返回:
元素

insertUpdate

protected void insertUpdate(AbstractDocument.DefaultDocumentEvent chng,
                            AttributeSet attr)
在文本插入后更新文档结构。这在一个写锁定内完成。此实现只解析插入的内容中的换行,然后为元素缓冲区建立一组指令。

覆盖:
AbstractDocument 中的 insertUpdate
参数:
chng - 对文档更改的描述
attr - 属性

removeUpdate

protected void removeUpdate(AbstractDocument.DefaultDocumentEvent chng)
在文本移除后更新文档结构。

覆盖:
AbstractDocument 中的 removeUpdate
参数:
chng - 对文档更改的描述

createDefaultRoot

protected AbstractDocument.AbstractElement createDefaultRoot()
创建用于代表默认文档结构的根元素。

返回:
基本元素

getForeground

public Color getForeground(AttributeSet attr)
从属性集获得前景色。

指定者:
接口 StyledDocument 中的 getForeground
参数:
attr - 属性集
返回:
颜色

getBackground

public Color getBackground(AttributeSet attr)
从属性集获得背景颜色。

指定者:
接口 StyledDocument 中的 getBackground
参数:
attr - 属性集
返回:
颜色

getFont

public Font getFont(AttributeSet attr)
从属性集获得字体。

指定者:
接口 StyledDocument 中的 getFont
参数:
attr - 属性集
返回:
字体

styleChanged

protected void styleChanged(Style style)
此文档样式有任何改变时调用。子类可能希望对损坏情况进行感知。

参数:
style - 已发生更改的样式。

addDocumentListener

public void addDocumentListener(DocumentListener listener)
添加负责通知任何更改的文档侦听器。

指定者:
接口 Document 中的 addDocumentListener
覆盖:
AbstractDocument 中的 addDocumentListener
参数:
listener - 侦听器
另请参见:
Document.addDocumentListener(javax.swing.event.DocumentListener)

removeDocumentListener

public void removeDocumentListener(DocumentListener listener)
移除文档侦听器。

指定者:
接口 Document 中的 removeDocumentListener
覆盖:
AbstractDocument 中的 removeDocumentListener
参数:
listener - 侦听器
另请参见:
Document.removeDocumentListener(javax.swing.event.DocumentListener)

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策