模块 java.desktop
包 javax.swing.event

接口 DocumentEvent

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

  • 方法详情

    • 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