GetContent

Description

Obtains an array of PBDOM_OBJECT objects, each of which is a child node of the PBDOM_ELEMENT object from which the method is invoked. The returned array is "live" in that changes to any item of the array affect the actual item to which the array refers.

Syntax

pbdom_element_name.GetContent(ref pbdom_object pbdom_object_array[ ])

Argument

Description

pbdom_element_name

The name of a PBDOM_ELEMENT object

pbdom_object_array

The name of an array of PBDOM_OBJECT objects that receive references to the PBDOM_OBJECT objects contained within the PBDOM_ELEMENT object


Return value

Boolean.

Returns true for success and false otherwise.

Throws

EXCEPTION_INVALID_ARGUMENT -- If the input array is null.

Examples

The GetContent method is invoked for the Root> PBDOM_ELEMENT object in the following XML DOM document:

<Root>
     <Element_1>
          <Element_1_1/>
          <Element_1_2/>
          <Element_1_3/>
     </Element_1>
     <Element_2/>
     <Element_3/>
</Root>

The GetContent method is invoked from the following PowerScript code:

PBDOM_DOCUMENT pbdom_doc
PBDOM_ELEMENT pbdom_elem_root
PBDOM_OBJECT pbdom_obj_array[]

pbdom_elem_root = pbdom_doc.GetRootElement()
pbdom_elem_root.GetContent(pbdom_obj_array)

If the GetContent method returns the value true, the PBDOM_OBJECT object pbdom_obj_array then contains the following content:

Array element

Value

1

<Element_1>

2

<Element_2>

3

<Element_3>


See also

AddContent Syntax 1

AddContent Syntax 2

InsertContent

RemoveContent

SetContent