Интерфейс 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, если элемент не был изменен
© 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.
