The IDLffXMLDOMTreeWalker class is used to navigate a DOM tree by creating a node object for accessing a DOM node and then destroying that node object as the tree walker is moved to another DOM node. The walker creates an object and returns an object reference to that object each time the walker moves, destroying the object that it last returned when the walker last moved. This process lets the application visit the nodes in a DOM tree efficiently and easily.

The tree walker is conceptually a “current” node pointer into the DOM tree. When the walker moves, it returns an object reference to a newly created instance of a node that represents the DOM node where the walker is now positioned.

The node specified when the tree walker is created is the root node for the walker. The walker is positioned at the root node when the walker is created. The walker cannot move to an ancestor of the root node. The root node, its children, and all of its siblings and their children compose the subtree visible to the walker.

The tree walker never destroys the IDLffXMLDOMDocument objects that it might return. The walker can only return an IDLffXMLDOMDocument object if an IDLffXMLDOMDocument object is the root node.

Objects of this class are created with the IDLffXMLDOMDocument::CreateTreeWalker method.

Superclasses


None

Creation


See IDLffXMLDOMTreeWalker::Init.

Properties


Objects of this class have no properties of their own, but do have properties inherited from any superclasses.

Methods


This class has the following methods:

In addition, this class inherits the methods of any superclasses.

Version History


6.2

Introduced