JavaTM 2 Platform
Standard Ed. 5.0

javax.swing.event
接口 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 事件模型为基础。传递给侦听器的传递顺序是没有保证的,并且在对 Document 做进一步的更改之前,必须通知所有侦听器。这意味着 DocumentListener 的实现不能更改事件源(即相关的 Document)

另请参见:
Document, StyledDocument, DocumentEvent

方法摘要
 void changedUpdate(DocumentEvent e)
          给出属性或属性集发生了更改的通知。
 void insertUpdate(DocumentEvent e)
          给出对文档执行了插入操作的通知。
 void removeUpdate(DocumentEvent e)
          给出移除了一部分文档的通知。
 

方法详细信息

insertUpdate

void insertUpdate(DocumentEvent e)
给出对文档执行了插入操作的通知。DocumentEvent 给出的范围限制了新的插入区域。

参数:
e - 文档事件

removeUpdate

void removeUpdate(DocumentEvent e)
给出移除了一部分文档的通知。根据最后看见的视图(即更新固定位置之前的视图)来给出范围。

参数:
e - 文档事件

changedUpdate

void changedUpdate(DocumentEvent e)
给出属性或属性集发生了更改的通知。

参数:
e - 文档事件

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策