Интерфейс DocumentEvent

Все известные реализующие классы:: AbstractDocument.DefaultDocumentEvent

public interface DocumentEvent

Интерфейс для уведомлений об изменениях документа. Он предоставляет наблюдателям Document подробную информацию об изменениях в документе. Он предоставляет общую информацию, например тип изменения и место, где оно произошло, а также более подробную информацию о структурных изменениях (какие элементы были вставлены и удалены).

См. также:

Краткое описание вложенных классов

Модификатор и тип	Интерфейс	Описание
`static interface`	`DocumentEvent.ElementChange`	Описывает изменения, внесённые в конкретный элемент.
`static final class`	`DocumentEvent.EventType`	Перечисление типов событий документа

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

Модификатор и тип	Метод	Описание
`DocumentEvent.ElementChange`	`getChange(Element elem)`	Возвращает сведения об изменении для указанного элемента.
`Document`	`getDocument()`	Возвращает документ, в котором произошло изменение, вызвавшее это событие.
`int`	`getLength()`	Возвращает длину изменения.
`int`	`getOffset()`	Возвращает смещение начала изменения в документе.
`DocumentEvent.EventType`	`getType()`	Возвращает тип события.

Подробное описание методов

getOffset

int getOffset()

Возвращает смещение начала изменения в документе.

Возвращает:: смещение >= 0

getLength

int getLength()

Возвращает длину изменения.

Возвращает:: длину >= 0

getDocument

Document getDocument()

Возвращает документ, в котором произошло изменение, вызвавшее это событие.

Возвращает:: документ

getType

DocumentEvent.EventType getType()

Возвращает тип события.

Возвращает:: тип

getChange

DocumentEvent.ElementChange getChange(Element elem)

Возвращает сведения об изменении для указанного элемента. Сведения об изменении описывают, какие элементы были добавлены и удалены, а также их расположение. Если изменений не было, возвращается null.

Этот метод позволяет наблюдателям обнаруживать структурные изменения. Это означает, что записи ElementChange нужны только для элементов, существовавших до изменения и продолжающих существовать после него. Предоставляемые сведения об изменениях не обязательно должны быть рекурсивными.

Например, если элемент удаляется из родительского элемента, этот метод должен сообщить об изменении родительского элемента и предоставить реализацию ElementChange, описывающую это изменение. Если у удалённого дочернего элемента были дочерние элементы, сообщать об их удалении не требуется.

Если дочерний элемент вставляется в родительский, родительский элемент должен сообщить об изменении. Если в дочерний элемент также были вставлены элементы (внуки родительского элемента), сообщать об их изменении не требуется.

Параметры:: elem — элемент
Возвращает:: сведения об изменении или null, если элемент не изменялся

© 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/DocumentEvent.html