Интерфейс DocumentListener

public interface DocumentListener
extends EventListener

Интерфейс для наблюдателя для регистрации получения уведомлений об изменениях в текстовом документе.

По умолчанию интерфейс Document (AbstractDocument) поддерживает асинхронные изменения. Если эта функция используется (т.е. изменения выполняются из потока, отличного от потока событий Swing), слушатели будут уведомляться через поток, выполняющий изменение. Это означает, что если асинхронные обновления производятся, реализация этого интерфейса должна быть потокобезопасной!

Уведомление DocumentEvent основано на модели событий JavaBeans. Нет гарантии относительно порядка доставки слушателям, и все слушатели должны быть уведомлены перед выполнением дальнейших изменений в документе. Это означает, что реализации DocumentListener не могут изменять источник события (т.е. связанный документ).

Методы

insertUpdate

void insertUpdate(DocumentEvent e)

Предоставляет уведомление о том, что в документ была произведена вставка. Диапазон, заданный DocumentEvent, ограничивает область, которая была вставлена.

Параметры:

e - событие документа

removeUpdate

void removeUpdate(DocumentEvent e)

Предоставляет уведомление о том, что часть документа была удалена. Диапазон задается с точки зрения того, что виртуальный интерфейс видел последний раз (то есть, перед обновлением закреплённых позиций).

Параметры:

e - событие документа

changedUpdate

void changedUpdate(DocumentEvent e)

Предоставляет уведомление о том, что изменился атрибут или набор атрибутов.

Параметры:

e - событие документа