http://xml.apache.org/http://www.apache.org/http://www.w3.org/

Home

Readme
Download
Installation
Build

API Docs
Samples
Schema

FAQs
Programming
Migration

Releases
Bug-Reporting
Feedback

Y2K Compliance
PDF Document

CVS Repository
Mail Archive

API Docs for SAX and DOM
 

Main Page   Class Hierarchy   Alphabetical List   Compound List   File List   Compound Members   File Members  

IDOM_TreeWalker Class Reference

IDOM_TreeWalker objects are used to navigate a document tree or subtree using the view of the document defined by its whatToShow flags and any filters that are defined for the IDOM_TreeWalker. More...

#include <IDOM_TreeWalker.hpp>

List of all members.

Public Methods

Get functions.
virtual IDOM_NodegetRoot ()=0
 The root node of the TreeWalker, as specified when it was created.

virtual unsigned long getWhatToShow ()=0
 Return which node types are presented via the IDOM_TreeWalker. More...

virtual IDOM_NodeFiltergetFilter ()=0
 Return The filter used to screen nodes.

virtual bool getExpandEntityReferences ()=0
 Return the expandEntityReferences flag. More...

virtual IDOM_NodegetCurrentNode ()=0
 Return the node at which the IDOM_TreeWalker is currently positioned.

virtual IDOM_NodeparentNode ()=0
 Moves to and returns the closest visible ancestor node of the current node. More...

virtual IDOM_NodefirstChild ()=0
 Moves the IDOM_TreeWalker to the first child of the current node, and returns the new node. More...

virtual IDOM_NodelastChild ()=0
 Moves the IDOM_TreeWalker to the last child of the current node, and returns the new node. More...

virtual IDOM_NodepreviousSibling ()=0
 Moves the IDOM_TreeWalker to the previous sibling of the current node, and returns the new node. More...

virtual IDOM_NodenextSibling ()=0
 Moves the IDOM_TreeWalker to the next sibling of the current node, and returns the new node. More...

virtual IDOM_NodepreviousNode ()=0
 Moves the IDOM_TreeWalker to the previous visible node in document order relative to the current node, and returns the new node. More...

virtual IDOM_NodenextNode ()=0
 Moves the IDOM_TreeWalker to the next visible node in document order relative to the current node, and returns the new node. More...

Set functions.
virtual void setCurrentNode (IDOM_Node *currentNode)=0
 Set the node at which the IDOM_TreeWalker is currently positioned.


Protected Methods

 IDOM_TreeWalker ()
 IDOM_TreeWalker (const IDOM_TreeWalker &other)
IDOM_TreeWalker& operator= (const IDOM_TreeWalker &other)


Detailed Description

IDOM_TreeWalker objects are used to navigate a document tree or subtree using the view of the document defined by its whatToShow flags and any filters that are defined for the IDOM_TreeWalker.

Any function which performs navigation using a IDOM_TreeWalker will automatically support any view defined by a IDOM_TreeWalker.

Omitting nodes from the logical view of a subtree can result in a structure that is substantially different from the same subtree in the complete, unfiltered document. Nodes that are siblings in the IDOM_TreeWalker view may be children of different, widely separated nodes in the original view. For instance, consider a Filter that skips all nodes except for Text nodes and the root node of a document. In the logical view that results, all text nodes will be siblings and appear as direct children of the root node, no matter how deeply nested the structure of the original document.


Constructor & Destructor Documentation

IDOM_TreeWalker::IDOM_TreeWalker ( ) [protected]
 

IDOM_TreeWalker::IDOM_TreeWalker ( const IDOM_TreeWalker & other ) [protected]
 


Member Function Documentation

IDOM_Node * IDOM_TreeWalker::firstChild ( ) [pure virtual]
 

Moves the IDOM_TreeWalker to the first child of the current node, and returns the new node.

If the current node has no children, returns null, and retains the current node.

IDOM_Node * IDOM_TreeWalker::getCurrentNode ( ) [pure virtual]
 

Return the node at which the IDOM_TreeWalker is currently positioned.

bool IDOM_TreeWalker::getExpandEntityReferences ( ) [pure virtual]
 

Return the expandEntityReferences flag.

The value of this flag determines whether the children of entity reference nodes are visible to the IDOM_TreeWalker. If false, they will be skipped over.

IDOM_NodeFilter * IDOM_TreeWalker::getFilter ( ) [pure virtual]
 

Return The filter used to screen nodes.

IDOM_Node * IDOM_TreeWalker::getRoot ( ) [pure virtual]
 

The root node of the TreeWalker, as specified when it was created.

unsigned long IDOM_TreeWalker::getWhatToShow ( ) [pure virtual]
 

Return which node types are presented via the IDOM_TreeWalker.

These constants are defined in the IDOM_NodeFilter interface.

IDOM_Node * IDOM_TreeWalker::lastChild ( ) [pure virtual]
 

Moves the IDOM_TreeWalker to the last child of the current node, and returns the new node.

If the current node has no children, returns null, and retains the current node.

IDOM_Node * IDOM_TreeWalker::nextNode ( ) [pure virtual]
 

Moves the IDOM_TreeWalker to the next visible node in document order relative to the current node, and returns the new node.

If the current node has no next node, or if the search for nextNode attempts to step upward from the IDOM_TreeWalker's root node, returns null, and retains the current node.

IDOM_Node * IDOM_TreeWalker::nextSibling ( ) [pure virtual]
 

Moves the IDOM_TreeWalker to the next sibling of the current node, and returns the new node.

If the current node has no next sibling, returns null, and retains the current node.

IDOM_TreeWalker & IDOM_TreeWalker::operator= ( const IDOM_TreeWalker & other ) [protected]
 

IDOM_Node * IDOM_TreeWalker::parentNode ( ) [pure virtual]
 

Moves to and returns the closest visible ancestor node of the current node.

If the search for parentNode attempts to step upward from the IDOM_TreeWalker's root node, or if it fails to find a visible ancestor node, this method retains the current position and returns null.

IDOM_Node * IDOM_TreeWalker::previousNode ( ) [pure virtual]
 

Moves the IDOM_TreeWalker to the previous visible node in document order relative to the current node, and returns the new node.

If the current node has no previous node, or if the search for previousNode attempts to step upward from the IDOM_TreeWalker's root node, returns null, and retains the current node.

IDOM_Node * IDOM_TreeWalker::previousSibling ( ) [pure virtual]
 

Moves the IDOM_TreeWalker to the previous sibling of the current node, and returns the new node.

If the current node has no previous sibling, returns null, and retains the current node.

void IDOM_TreeWalker::setCurrentNode ( IDOM_Node * currentNode ) [pure virtual]
 

Set the node at which the IDOM_TreeWalker is currently positioned.


The documentation for this class was generated from the following file:


Copyright © 2000 The Apache Software Foundation. All Rights Reserved.