Module java.desktop
Package javax.swing.event

Interface DocumentListener

所有超级接口:
EventListener
所有已知实现类:
JEditorPane.AccessibleJEditorPane, JEditorPane.AccessibleJEditorPaneHTML, JEditorPane.JEditorPaneAccessibleHypertextSupport, JPasswordField.AccessibleJPasswordField, JTextArea.AccessibleJTextArea, JTextComponent.AccessibleJTextComponent, JTextField.AccessibleJTextField
public interface DocumentListener extends EventListener
用于注册接收文本文档更改通知的观察者接口。

Document接口的默认实现（AbstractDocument）支持异步变化。如果使用此功能（即从Swing事件线程以外的线程进行变化），则侦听器将通过变异线程收到通知。这意味着如果进行异步更新，则此接口的实现必须是线程安全的！

DocumentEvent通知基于JavaBeans事件模型。不能保证向侦听器传递的顺序，并且在对文档进行进一步变更之前必须通知所有侦听器。这意味着DocumentListener的实现可能不会改变事件源（即关联的Document）。

参见:

  • Method Details

    • insertUpdate

      void insertUpdate(DocumentEvent e)
      通知文档已插入内容。DocumentEvent给出了刚插入区域的范围。
      参数:
      e - 文档事件

    • removeUpdate

      void removeUpdate(DocumentEvent e)
      通知文档的一部分已被移除。范围是根据视图最后看到的内容给出的（即在更新粘性位置之前）。
      参数:
      e - 文档事件

    • changedUpdate

      void changedUpdate(DocumentEvent e)
      通知属性或一组属性已更改。
      参数:
      e - 文档事件