Module  java.desktop
软件包  javax.swing.event

Interface DocumentEvent

  • 所有已知实现类:
    AbstractDocument.DefaultDocumentEvent


    public interface DocumentEvent
    文档更改通知界面。 这将向文档观察者提供有关文档更改的详细信息。 它提供了高级别的信息,例如变化的类型和发生的地方,以及更详细的结构变化(插入和删除了什么元素)。
    另请参见:
    DocumentDocumentListener
    • 方法详细信息

      • getOffset

        int getOffset​()
        返回变更开始文档中的偏移量。
        结果
        offset> = 0
      • getLength

        int getLength​()
        返回更改的长度。
        结果
        长度> = 0
      • getDocument

        Document getDocument​()
        获取来源于更改事件的文档。
        结果
        文件
      • getChange

        DocumentEvent.ElementChange getChange​(Element elem)
        获取给定元素的更改信息。 更改信息描述添加和删除的元素以及位置。 如果没有更改,则返回null。

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

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

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

        参数
        elem - 元素
        结果
        更改信息,如果元素未被修改,则为null