Интерфейс 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 не должны изменять источник события (т.е. связанный документ).

См. также:

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

Модификатор и тип	Метод	Описание
`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, 2021, 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/17/docs/api/java.desktop/javax/swing/event/DocumentListener.html