IDLffXMLDOMTreeWalker::NextNode

The IDLffXMLDOMTreeWalker::NextNode function method creates an object that is a subclass of IDLffXMLDOMNode and returns the object reference to that object. The object refers to the node in the DOM tree that is visited next after the walker's current node in document-order traversal.

If the current node has no next node or the search for the next node looks above the tree walker's root node, this method returns a null object reference, and the current node does not change. Otherwise, the DOM tree node to which the returned object refers becomes the current node in the tree walker.

This method destroys the object returned by the most recent previous invocation of any of the following navigation methods:

• IDLffXMLDOMTreeWalker::FirstChild
• IDLffXMLDOMTreeWalker::GetCurrentNode
• IDLffXMLDOMTreeWalker::LastChild
• IDLffXMLDOMTreeWalker::NextNode
• IDLffXMLDOMTreeWalker::NextSibling
• IDLffXMLDOMTreeWalker::ParentNode
• IDLffXMLDOMTreeWalker::PreviousNode
• IDLffXMLDOMTreeWalker::PreviousSibling

A node object returned by this method is destroyed when the tree walker is destroyed.

Syntax

Result = Obj->[IDLffXMLDOMTreeWalker::]NextNode()

Return Value

Returns an object reference to the next node in the DOM tree in the tree walker’s document-order traversal, or a null object reference if the current node has no next node or the search for the next node looks above the walker's root node.

Arguments

None

Keywords

None

Version History

6.2	Introduced