javax.swing.event

Interface DocumentEvent

所有已知实现类：

AbstractDocument.DefaultDocumentEvent

public interface DocumentEvent

文档更改通知界面。 这将向文档观察者提供有关文档更改的详细信息。 它提供了高级别的信息，例如变化的类型和发生的地方，以及更详细的结构变化（插入和删除了什么元素）。

另请参见：

Document ， DocumentListener

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	DocumentEvent.ElementChange 描述对特定元素所做的更改。
static class	DocumentEvent.EventType 文档事件类型的枚举

方法摘要

Modifier and Type	Method and Description
DocumentEvent.ElementChange	getChange(Element elem) 获取给定元素的更改信息。
Document	getDocument() 获取来源于更改事件的文档。
int	getLength() 返回更改的长度。
int	getOffset() 返回变更开始文档中的偏移量。
DocumentEvent.EventType	getType() 获取事件的类型。

方法详细信息

getOffset

int getOffset()

返回变更开始文档中的偏移量。

结果

offset> = 0

getLength

int getLength()

返回更改的长度。

结果

长度> = 0

getDocument

Document getDocument()

获取来源于更改事件的文档。

结果

文件

getType

DocumentEvent.EventType getType()

获取事件的类型。

结果

方式

getChange

DocumentEvent.ElementChange getChange(Element elem)

获取给定元素的更改信息。 更改信息描述添加和删除的元素以及位置。 如果没有更改，则返回null。

这种方法是观察者发现所做的结构变化。 这意味着只有突变之前存在的元素（并且在突变之后仍然存在）需要具有ElementChange记录。 可用的更改不需要递归。

例如，如果一个元素从其父项中移除，则此方法应报告父更改，并提供描述父对象的更改的ElementChange实现。 如果删除的子元素有子元素，则不需要将这些元素报告为已删除。

如果子元素插入到父元素中，则父元素应该报告更改。 如果子元素也插入了元素（孙子对父），这些元素不需要报告更改。

参数

elem - 元素

结果

更改信息，如果元素未被修改，则为null