PBDOM_ELEMENT:
GetChildElements Syntax 3 method
Description
Retrieves a list of all child PBDOM_ELEMENT objects
nested one level deep within a PBDOM_ELEMENT object specified
by the local name and namespace provided.
Syntax
1 |
<span>pbdom_element_name.</span>GetChildElements(string <span>strElementName</span>, string <span>strNamespacePrefix</span>, string <span>strNamespaceUri</span>, ref pbdom_element <span>pbdom_element_array</span>[]) |
Argument |
Description |
---|---|
pbdom_element_name |
The name of a PBDOM_ELEMENT |
strElementName |
The name of a PBDOM_ELEMENT |
strNamespacePrefix |
The prefix of the namespace of the child PBDOM_ELEMENT |
strNamespaceUri |
The URI of the namespace of the child PBDOM_ELEMENT |
pbdom_element_array[] |
The array that stores the child PBDOM_ELEMENT objects |
Return Values
Boolean. Returns true if
child PBDOM_ELEMENT objects have been collected, and false otherwise.
Throws
EXCEPTION_INVALID_ARGUMENT – If
any of the parameters is invalid.
EXCEPTION_INVALID_NAME – If
the input element name or namespace prefix or namespace URI is invalid.
The only exception is if the input element name is an empty string.
Usage
If the PBDOM_ELEMENT object has no nested elements, GetChildElements returns
an empty array.
If the value of strElementName is an
empty string, then all child elements match.