Module java.desktop
Package javax.swing.text

Interface Element

所有已知的实现类:
AbstractDocument.AbstractElement, AbstractDocument.BranchElement, AbstractDocument.LeafElement, DefaultStyledDocument.SectionElement, HTMLDocument.BlockElement, HTMLDocument.RunElement
public interface Element
描述文档结构片段的接口。旨在捕捉 SGML 元素的精神。

  • Method Details

    • 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)
      获取最接近给定偏移量的子元素索引。偏移量相对于文档开头指定。如果 Element 是叶子，则返回 -1，否则返回最能代表给定位置的 Element 的索引。如果位置小于起始偏移量，则返回 0。如果位置大于或等于结束偏移量，则返回 getElementCount() - 1。
      参数:
      offset - 指定的偏移量 >= 0
      返回:
      元素索引 >= 0

    • getElementCount

      int getElementCount()
      获取此元素包含的子元素数量。如果此元素是叶子，则返回零计数。
      返回:
      子元素数量 >= 0

    • getElement

      Element getElement(int index)
      获取给定索引处的子元素。
      参数:
      index - 指定的索引 >= 0
      返回:
      子元素

    • isLeaf

      boolean isLeaf()
      此元素是否为叶子元素？即使当前没有子元素，也可能有子元素的元素将返回 false。
      返回:
      如果是叶子元素则为 true，否则为 false