public interface DocumentTraversal
DocumentTraversal
には、ドキュメント順 (深さ優先の行きがけ順トラバーサル、ドキュメントのテキスト表現で開始タグが発生する順序と同じ) にノードとノードの子をトラバースするための NodeIterator
や TreeWalker
を作成するメソッドがあります。Traversal 機能をサポートする DOM では、DocumentTraversal
は Document インタフェースを実装するオブジェクトと同じオブジェクトにより実装されます。
「Document Object Model (DOM) Level 2 Traversal and Range Specification」も参照してください。
修飾子と型 | メソッドと説明 |
---|---|
NodeIterator |
createNodeIterator(Node root, int whatToShow, NodeFilter filter, boolean entityReferenceExpansion)
指定されたノードをルートとするサブツリー上に新規の
NodeIterator を作成します。 |
TreeWalker |
createTreeWalker(Node root, int whatToShow, NodeFilter filter, boolean entityReferenceExpansion)
指定されたノードをルートとするサブツリー上に新規の
TreeWalker を作成します。 |
NodeIterator createNodeIterator(Node root, int whatToShow, NodeFilter filter, boolean entityReferenceExpansion) throws DOMException
NodeIterator
を作成します。root
- 子と一緒に反復処理されるノード。NodeIterator
は、最初はこのノードのすぐ前に配置される。この位置を設定するとき、whatToShow
フラグとフィルタは存在しても考慮されない。ルートは null
であってはならない。whatToShow
- このフラグは NodeIterator
によって表されたツリーの論理ビューに表示可能なノードの型を指定する。可能な SHOW_
値のセットについては、NodeFilter
の説明を参照。フラグは OR
を使って結合できる。filter
- この NodeIterator
とともに使用される NodeFilter
、フィルタを指定しない場合は null
。entityReferenceExpansion
- このフラグの値は、実体参照ノードが展開されるかどうかを判定する。NodeIterator
。DOMException
- NOT_SUPPORTED_ERR:指定されたroot
が null
の場合に発生する。TreeWalker createTreeWalker(Node root, int whatToShow, NodeFilter filter, boolean entityReferenceExpansion) throws DOMException
TreeWalker
を作成します。root
- TreeWalker
の root
として機能するノード。whatToShow
フラグと NodeFilter
は、この値を設定するとき考慮されない。任意のノード型が root
として受け入れられる。TreeWalker
の currentNode
は、可視であるかどうかにかかわらずこのノードに初期化される。root
は、parentNode
や nextNode など、ドキュメント構造で上に向かって検出するトラバーサルメソッドの停止点として機能する。root
は null
であってはならない。whatToShow
- このフラグは TreeWalker
によって表されたツリーの論理ビューに表示可能なノードの型を指定する。可能な SHOW_
値のセットについては、NodeFilter
の説明を参照。フラグは OR
を使って結合できる。filter
- この TreeWalker
とともに使用される NodeFilter
、フィルタを指定しない場合は null
。entityReferenceExpansion
- このフラグが false の場合、EntityReference
ノードの内容は論理ビューに表示されない。TreeWalker
。DOMException
- NOT_SUPPORTED_ERR:指定されたroot
が null
の場合に発生する。 バグまたは機能を送信
Java は米国ならびにその他の国における Oracle Corporation およびその関連企業の商標または登録商標です。
Copyright © 2005, 2013, Oracle and/or its affiliates. 500 Oracle Parkway
Redwood Shores, CA 94065 USA. All rights reserved.