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