javax.swing.event
介面 DocumentEvent

所有已知實作類別：

AbstractDocument.DefaultDocumentEvent

public interface DocumentEvent

用於文檔更改通知的介面。此介面為 Document 觀察者提供了有關 Document 更改方式的細節資訊。它提供一些高層級資訊，比如更改型別、在哪兒發生更改，以及更多具體的結構性更改（插入和移除哪些 Element）。

另請參見：

Document, DocumentListener

巢狀類別摘要

static interface	DocumentEvent.ElementChange 描述對特定元素所做的更改。
static class	DocumentEvent.EventType 文檔事件型別的列舉

方法摘要

DocumentEvent.ElementChange	getChange(Element elem) 獲得給定元素的更改資訊。
Document	getDocument() 獲得發起更改事件的文檔。
int	getLength() 返回更改的長度。
int	getOffset() 返回文檔中更改開始的偏移量。
DocumentEvent.EventType	getType() 獲得事件型別。

方法詳細資訊

getOffset

int getOffset()

返回文檔中更改開始的偏移量。

返回：

偏移量，該偏移量 >= 0

getLength

int getLength()

返回更改的長度。

返回：

長度，該長度 >= 0

getDocument

Document getDocument()

獲得發起更改事件的文檔。

返回：

文檔

getType

DocumentEvent.EventType getType()

獲得事件型別。

返回：

型別

getChange

DocumentEvent.ElementChange getChange(Element elem)

獲得給定元素的更改資訊。更改資訊描述了哪些元素被添加和移處，以及添加和移處的位置。如果沒有更改，則返回 null。

此方法適用於觀察者發現已完成的結構性更改。這意味著只有發生變化之前存在的元素（以及發生變化之後仍然存在的元素）需要有 ElementChange 記錄。變得可用的更改不必是遞歸的。

例如，如果從父元素中移除某個元素，則此方法應該報告該父元素已更改，並提供描述父元素的更改的 ElementChange 實作。如果已移除的子元素有子級，則在移除時不需要報告這些元素。

如果子元素被插入到父元素中，則父元素應該報告此更改。如果子元素中還有一些已插入其中的元素（父元素的孫級），則這些元素無需報告發生的更改。

參數：

elem - 元素

返回：

更改資訊，如果元素未被修改，則返回 null