Элемент интерфейса

Все известные реализующие классы:: 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();

См. также:

getEndOffset

int getEndOffset()

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

Все реализации по умолчанию Document происходят от AbstractDocument. AbstractDocument моделирует неявный разрыв в конце документа. В результате этого возможно, что это вернет значение, большее, чем длина документа.

Возвращает:

конечное смещение > getStartOffset() и <= getDocument().getLength() + 1

См. также:

getElementIndex

int getElementIndex(int offset)

Получает индекс дочернего элемента, наиболее близкий к заданному смещению. Смещение задается относительно начала документа. Возвращает -1, если Element является листовым элементом, в противном случае возвращает индекс Element, который лучше всего представляет заданное местоположение. Возвращает 0, если местоположение меньше начального смещения. Возвращает getElementCount() - 1, если местоположение больше или равно конечному смещению.

Параметры:: offset - заданное смещение >= 0
Возвращает:: индекс элемента >= 0

getElementCount

int getElementCount()

Возвращает количество дочерних элементов, содержащихся в этом элементе. Если этот элемент является листовым, возвращается значение 0.

Возвращает:: количество дочерних элементов >= 0

getElement

Element getElement(int index)

Получает дочерний элемент по заданному индексу.

Параметры:: index - заданный индекс >= 0
Возвращает:: дочерний элемент

isLeaf

boolean isLeaf()

Является ли этот элемент листовым элементом? Элемент, который может иметь дочерние элементы, даже если он сейчас не имеет дочерних элементов, вернет false.

Возвращает:: true, если листовой элемент, иначе false

© 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/text/Element.html