Интерфейс DocumentEvent

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

public interface DocumentEvent

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

См. также:: Document, DocumentListener

Вложенные классы

Модификатор и тип	Интерфейс	Описание
`static interface`	`DocumentEvent.ElementChange`	Описывает изменения, внесенные в определенный элемент.
`static 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, если элемент не был изменен