JavaTM Platform
Standard Ed. 6

javax.swing.text
クラス ElementIterator

java.lang.Object
  上位を拡張 javax.swing.text.ElementIterator
すべての実装されたインタフェース:
Cloneable

public class ElementIterator
extends Object
implements Cloneable

ElementIterator は、その名前が示すとおり、要素ツリーを繰り返し処理します。コンストラクタを呼び出すには、ドキュメントまたは要素を引数に使います。ドキュメントを引数としてコンストラクタを呼び出すと、繰り返しのルートは document.getDefaultRootElement() の戻り値になります。 深さ優先方式で繰り返します。境界の処理法は次のとおりです。a) first() または current() より先に next() が呼び出された場合は、ルートを返します。 b) next() は null を返してリストの末尾を示します。 c) 現在の要素がルートの場合、または next() が null を返した場合は、previous() は null を返します。 ElementIterator は要素ツリーをロックしません。つまり、ElementIterator はどのような変更も追跡しません。このクラスのユーザーが、要素の繰り返し処理で変更が生じていないことを確認する必要があります。 次に、簡単な使用例を示します。 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 を取得します。

戻り値:
スタック上の要素。 ルート要素が null の場合は null

next

public Element next()
次の Element を取得します。次の要素を見つけるには深さ優先探索が使われます。

戻り値:
次の要素。リスト末尾では null

previous

public Element previous()
直前の Element を取得します。現在の要素が最後の要素か null の場合は、null が返されます。

戻り値:
利用できる場合は前の Element

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。