Module java.desktop
Package javax.swing.event

Interface DocumentEvent

所有已知的实现类:
AbstractDocument.DefaultDocumentEvent
public interface DocumentEvent
文档更改通知的接口。这为文档观察者提供了关于文档如何更改的详细信息。它提供了高级信息，例如更改的类型和发生更改的位置，以及更详细的结构更改（插入和删除的元素是什么）。
参见:

  • Method Details

    • 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