javax.swing.text
類別 ElementIterator

java.lang.Object
  javax.swing.text.ElementIterator

所有已實作的介面：

Cloneable

public class ElementIterator
extends Object
implements Cloneable

ElementIterator，顧名思義，沿 Element 階層樹進行迭代。可使用 Document 或 Element 參數調用此建構子。如果以 Document 為參數調用此建構子，那麼迭代的根為 document.getDefaultRootElement() 的返回值。 迭代以深度優先 (depth-first) 的方式進行。至於如何處理邊界條件：a) 如果 next() 在 first() 或 current() 之前調用，將返回根。b) next() 返回 null 指示列表的末尾。c) 如果當前元素為根或 next() 已經返回 null 時，previous() 返回 null。 ElementIterator 並不鎖定 Element 階層樹。這意味著它不追蹤任何更改。由此類別的使用者負責確保元素迭代期間不出現更改。 簡單用法範例： public void iterate() { ElementIterator it = new ElementIterator(root); Element elem; while (true) { if ((elem = next()) != null) { // process element System.out.println("elem: " + elem.getName()); } else { break; } } }

建構子摘要

ElementIterator(Document document)
創建新的 ElementIterator。

ElementIterator(Element root)
創建新的 ElementIterator。

方法摘要

Object	clone() 複製 ElementIterator。
Element	current() 獲取當前 Element。
int	depth() 獲取元素階層樹的當前深度。
Element	first() 獲取第一個元素。
Element	next() 獲取下一個 Element。
Element	previous() 獲取前一個 Element。

從類別 java.lang.Object 繼承的方法

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

建構子詳細資訊

ElementIterator

public ElementIterator(Document document)

創建新的 ElementIterator。根元素用於獲得文檔的預設根元素。

參數：

document - Document。

ElementIterator

public ElementIterator(Element root)

創建新的 ElementIterator。

參數：

root - 根 Element。

方法詳細資訊

clone

public Object clone()

複製 ElementIterator。

覆寫：

類別 Object 中的 clone

返回：

複製的 ElementIterator 物件。

另請參見：

Cloneable

first

public Element first()

獲取第一個元素。

返回：

Element。

depth

public int depth()

獲取元素階層樹的當前深度。

返回：

深度。

current

public Element current()

獲取當前 Element。

返回：

位於堆疊(stack)空間頂部的元素，如果根元素為 null 則返回 null

next

public Element next()

獲取下一個 Element。定位下一個元素的策略是深度優先搜尋。

返回：

下一個元素，如果位於列表末尾，則返回 null。

previous

public Element previous()

獲取前一個 Element。但是如果當前元素為最後一個元素，或者當前元素為 null，則返回 null。

返回：

前一個 Element（如果有）