Интерфейс 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, 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 - событие документа

© 1993, 2020, 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/11/docs/api/java.desktop/javax/swing/event/DocumentListener.html

Spec-Zone .ru
спецификации, руководства, описания, API