Интерфейс элемента
- Все известные реализующие классы:
- AbstractDocument.AbstractElement, AbstractDocument.BranchElement, AbstractDocument.LeafElement, DefaultStyledDocument.SectionElement, HTMLDocument.BlockElement, HTMLDocument.RunElement
public interface Element
Интерфейс для описания структурной части документа. Он предназначен для отражения идеи элемента SGML.
Методы
| Модификатор и тип | Метод и описание |
|---|---|
AttributeSet |
getAttributes() Извлекает коллекцию атрибутов, содержащихся в этом элементе. |
Document |
getDocument() Извлекает документ, связанный с этим элементом. |
Element |
getElement(int index) Извлекает дочерний элемент по заданному индексу. |
int |
getElementCount() Возвращает количество дочерних элементов, содержащихся в этом элементе. |
int |
getElementIndex(int offset) Возвращает индекс дочернего элемента, ближайшего к заданному смещению. |
int |
getEndOffset() Извлекает смещение от начала документа, до которого достигает этот элемент. |
String |
getName() Извлекает имя элемента. |
Element |
getParentElement() Извлекает родительский элемент. |
int |
getStartOffset() Извлекает смещение от начала документа, с которого начинается этот элемент. |
boolean |
isLeaf() Является ли этот элемент листовым элементом? Элемент, который может иметь потомков, даже если у него сейчас нет потомков, вернет |
Методы
getDocument
Document getDocument()
Извлекает документ, связанный с этим элементом.
- Возвращает:
- документ
getParentElement
Element getParentElement()
Извлекает родительский элемент. Если элемент является корневым, возвращает null.
- Возвращает:
- родительский элемент
getName
String getName()
Извлекает имя элемента. Если элемент используется для представления какого-либо типа структуры, это будет имя типа.
- Возвращает:
- имя элемента
getAttributes
AttributeSet getAttributes()
Извлекает коллекцию атрибутов, содержащихся в этом элементе.
- Возвращает:
- атрибуты элемента
getStartOffset
int getStartOffset()
Извлекает смещение от начала документа, с которого начинается этот элемент. Если у этого элемента есть потомки, это будет смещение первого потомка. В качестве позиции документа подразумевается смещение вперёд.
- Возвращает:
- смещение начала >= 0 и < getEndOffset();
- См. также:
-
Document,AbstractDocument
getEndOffset
int getEndOffset()
Извлекает смещение от начала документа, до которого достигает этот элемент. Если у этого элемента есть потомки, это будет смещение последнего потомка. В качестве позиции документа подразумевается смещение назад.
Все реализации по умолчанию Document наследуются от AbstractDocument. AbstractDocument моделирует неявный разрыв в конце документа. В результате этого возможно, что это вернёт значение, большее, чем длина документа.
- Возвращает:
- смещение конца > getStartOffset() и <= getDocument().getLength() + 1
- См. также:
-
Document,AbstractDocument
getElementIndex
int getElementIndex(int offset)
Возвращает индекс дочернего элемента, ближайшего к заданному смещению. Смещение задано относительно начала документа. Возвращает -1 если Element является листовым, в противном случае возвращает индекс Element, который лучше всего представляет заданное местоположение. Возвращает 0 если местоположение меньше смещения начала. Возвращает getElementCount() - 1 если местоположение больше или равно смещению конца.
- Параметры:
-
offset- указанное смещение >= 0 - Возвращает:
- индекс элемента >= 0
getElementCount
int getElementCount()
Возвращает количество дочерних элементов, содержащихся в этом элементе. Если этот элемент является листовым, возвращается ноль.
- Возвращает:
- количество дочерних элементов >= 0
getElement
Element getElement(int index)
Извлекает дочерний элемент по заданному индексу.
- Параметры:
-
index- указанный индекс >= 0 - Возвращает:
- дочерний элемент
isLeaf
boolean isLeaf()
Является ли этот элемент листовым элементом? Элемент, который может иметь потомков, даже если у него сейчас нет потомков, вернёт false.
- Возвращает:
- true, если листовой элемент, иначе false
© 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.