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

См. также:

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

Модификатор и тип	Метод	Описание
`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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/event/DocumentListener.html