Spec-Zone.ru › OpenJDK 21

Интерфейс 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)
Предоставляет уведомление о удалении части документа. Диапазон задан с точки зрения того, что видел просмотр последний раз (т. е. до обновления позиций "sticky").
Параметры:
e - событие документа

changedUpdate

void changedUpdate(DocumentEvent e)
Предоставляет уведомление о изменении атрибута или набора атрибутов.
Параметры:
e - событие документа

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API