Description
Inserts a new PBDOM_OBJECT into the current PBDOM_OBJECT.
Syntax
pbdom_object_name.InsertContent(pbdom_object_new, pbdom_object_ref)
|
Argument |
Description |
|---|---|
|
pbdom_object_name |
The name of the PBDOM_OBJECT |
|
pbdom_object_new |
The referenced name of a PBDOM_OBJECT you want to insert |
|
pbdom_object_ref |
The name of the PBDOM_OBJECT in front of which you want to insert the new PBDOM_OBJECT |
Return value
PBDOM_OBJECT. The return value is the newly modified PBDOM_OBJECT.
Throws
EXCEPTION_PBDOM_OBJECT_INVALID_FOR_USE -- This PBDOM_OBJECT object or the new PBDOM_OBJECT or the reference PBDOM_OBJECT is not associated with a derived PBDOM_OBJECT class object.
EXCEPTION_INVALID_ARGUMENT -- One of the input arguments is invalid. This can happen if the input argument has not been initialized properly or is a null object reference.
Usage
When a new PBDOM_OBJECT is inserted into the current PBDOM_OBJECT, the new PBDOM_OBJECT becomes a child node of the current PBDOM_OBJECT. Also, the new PBDOM_OBJECT is to be positioned specifically before another PBDOM_OBJECT, designated using the second parameter.
If the second PBDOM_OBJECT is specified as null, then the new PBDOM_OBJECT is to be inserted at the end of the list of children of the current PBDOM_OBJECT.
Derived Classes
Methods of classes that derive from the PBDOM_OBJECT class return trivial results when the derived classes can have no child objects and when the methods concern manipulation of child-node content.
See also
