HasChildren
Description
Determines whether this PBDOM_ATTRIBUTE object contains any child
PBDOM_OBJECTs.
Syntax
|
1 |
pbdom_attribute_name.HasChildren() |
|
Argument |
Description |
|---|---|
|
pbdom_attribute_name |
The name of the PBDOM_ATTRIBUTE |
Return value
Boolean.
Returns true if this PBDOM_ATTRIBUTE contains child objects and
false otherwise.
Throws
EXCEPTION_PBDOM_OBJECT_INVALID_FOR_USE — This PBDOM_OBJECT
object is not associated with a derived PBDOM_OBJECT class
object.
Examples
This example creates a PBDOM_DOCUMENT from a string. The XML
document in the string already contains a root element named root that
contains an attribute attr that contains an empty string. It then
represents attr as a PBDOM_ATTRIBUTE object and calls its
HasChildren method, which returns true because a PBDOM_ATTRIBUTE always
contains at least one child object. After a call to GetContent, the
message box shows that attr contains only one child, a PBDOM_TEXT that
represents the empty string:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
PBDOM_BUILDER pbdom_buildr PBDOM_DOCUMENT pbdom_doc PBDOM_ATTRIBUTE pbdom_attr string strXML = "<root attr=~"~"></root>" try pbdom_buildr = Create PBDOM_BUILDER pbdom_doc = pbdom_buildr.BuildFromString(strXML) pbdom_attr = pbdom_doc.GetRootElement(). & GetAttribute("attr") if (pbdom_attr.HasChildren()) then PBDOM_OBJECT pbdom_obj_array[] long l = 0 pbdom_attr.GetContent(pbdom_obj_array) for l = 1 to UpperBound (pbdom_obj_array) MessageBox ("Attr Child Object", & pbdom_obj_array[l].GetObjectClassString()) next end if catch (pbdom_exception pbdom_e) MessageBox ("PBDOM_EXCEPTION", pbdom_e.GetMessage()) end try |
Usage
This method checks to see if this PBDOM_ATTRIBUTE object contains
any child PBDOM_OBJECTs and returns true if it does. Note that according
to the W3C DOM specification, a DOM Attribute Node can contain only Text
and Entity Reference Nodes, therefore a PBDOM_ATTRIBUTE object can
contain only PBDOM_TEXT and PBDOM_ENTITYREFERENCE objects.
Even if a PBDOM_ATTRIBUTE object’s text value is an empty string,
it always contains at least one PBDOM_TEXT object that represents the
empty string.