Append Syntax 2
Description
Appends the text data of a PBDOM_CHARACTERDATA object to the
text content that already exists within the current
PBDOM_CHARACTERDATA object.
Syntax
|
1 |
pbdom_text_name.Append(pbdom_characterdata pbdom_characterdata_ref) |
|
Argument |
Description |
|---|---|
|
pbdom_text_name |
The name of a PBDOM_CHARACTERDATA |
|
pbdom_characterdata_ref |
The referenced PBDOM_CHARACTERDATA object whose |
Return value
PBDOM_CHARACTERDATA. The current PBDOM_CHARACTERDATA modified
and returned as a PBDOM_CHARACTERDATA object.
Throws
EXCEPTION_PBDOM_OBJECT_INVALID_FOR_USE — If the current
PBDOM_CHARACTERDATA or the input PBDOM_CHARACTERDATA is not a
reference to an object derived from PBDOM_CHARACTERDATA.
Usage
Note that JDOM does not define an Append method for its
CHARACTERDATA class. Because PBDOM implements its Append method in the
base PBDOM_CHARACTERDATA class, a PBDOM_TEXT object, a PBDOM_CDATA
object, and a PBDOM_TEXT object can append their internal text data to
each other because they are all PBDOM_CHARACTERDATA-derived
objects.