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()

取偏离此元素在文档的开头开始。如果这个元素有孩子，这将是第一个孩子的偏移量。作为一个文档的位置，有一个隐含的正向偏差。

结果

起始偏移>和< getendoffset() = 0；

另请参见：

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。

结果

如果一个叶元素是假的