Module java.desktop

软件包 javax.swing.event

Interface DocumentListener

All Superinterfaces:

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 ， StyledDocument ， DocumentEvent

方法摘要

Modifier and Type	方法	描述
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 - the document event