The IDLffXMLDOMElement::GetElementsByTagName function method creates an IDLffXMLDOMNodeList object containing all descendant element nodes in the document tree with the specified tag name and returns an object reference to the IDLffXMLDOMNodeList object. The nodes are placed in the node list in the order that they are encountered during a preorder traversal of the tree.

Syntax


Result = Obj->[IDLffXMLDOMElement::]GetElementsByTagName( TagName )

Return Value


Returns an object reference to the IDLffXMLDOMNodeList object.

The returned node list is “live,” in that any changes made to the document tree after the node list was returned will be immediately reflected in the node list.

If no nodes matching the specified tag name are found, an IDLffXMLDOMNodeList is still returned, but contains no nodes.

Arguments


TagName

A scalar string containing the tag name that is used to match the elements. The value “*” matches all tags only; it is not a wildcard expression, and you cannot use it to make partial matches.

Keywords


None

Version History


6.1

Introduced