Интерфейс 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).

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`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 - событие документа

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/event/DocumentListener.html