IDLffXMLDOMTreeWalker::ParentNode

The IDLffXMLDOMTreeWalker::ParentNode 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 the parent of the node to which the walker is currently pointing.

If the search for a parent node attempts to look above the tree walker's root node or no visible ancestor node is found, 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::]ParentNode()

Return Value

Returns the object reference to the parent of the node in the DOM tree to which the tree walker is pointing, or a null object reference if the search cannot find a visible ancestor node or attempts to look above the walker’s root node.

Arguments

None

Keywords

None

Version History

6.2	Introduced