javax.swing.text

Interface Element

所有已知实现类：

AbstractDocument.AbstractElement ， AbstractDocument.BranchElement ， AbstractDocument.LeafElement ， DefaultStyledDocument.SectionElement ， HTMLDocument.BlockElement ， HTMLDocument.RunElement

public interface Element

描述文档的结构部分的界面。 它旨在捕捉SGML元素的精神。

方法摘要

Modifier and Type	Method and Description
AttributeSet	getAttributes() 获取此元素包含的属性集合。
Document	getDocument() 获取与此元素关联的文档。
Element	getElement(int index) 在给定索引处获取子元素。
int	getElementCount() 获取此元素包含的子元素的数量。
int	getElementIndex(int offset) 获取最接近给定偏移量的子元素索引。
int	getEndOffset() 从文档的开始处获取该元素结束的偏移量。
String	getName() 获取元素的名称。
Element	getParentElement() 获取父元素。
int	getStartOffset() 从该元素开头的文档开始处获取偏移量。
boolean	isLeaf() 这个元素是叶元素吗？ 一个可能有孩子的元素，即使它目前没有孩子，将返回false 。

方法详细信息

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)

获取最接近给定偏移量的子元素索引。 相对于文档的开头指定了偏移量。 如果Element是叶，则返回-1 ，否则返回最能代表给定位置的Element的索引。 如果位置小于起始偏移量，则返回0 。 如果位置大于或等于结束偏移量，则返回getElementCount() - 1 。

参数

offset - 指定的偏移量> = 0

结果

元素索引> = 0

getElementCount

int getElementCount()

获取此元素包含的子元素的数量。 如果这个元素是一个叶子，返回一个零的计数。

结果

子元素的数量> = 0

getElement

Element getElement(int index)

在给定索引处获取子元素。

参数

index - 指定的索引> = 0

结果

子元素

isLeaf

boolean isLeaf()

这个元素是叶元素吗？ 可能有孩子的元素，即使它目前没有孩子，将返回false 。

结果

如果叶子元素为false，则为true