|
|
For example, if the Document contains as text the
string "This is a test", the following code:
will modify the text of the Document to
"This is a simple test".
The most important aspect of this function is that it will make the proper arrangements so as the Annotations contained inside the Document to be displaced by a proper amound of characters so as Annotations spanning text ranges after the insertion point to span the same text portions, after the string has been inserted.
This function will return the new Document text (as an object of type CDM_ByteSequence) if the insertion was succesful. Note that the returned object is owned by the CDM. The caller is not supposed to free or modify the returned object.
In case of an error, NULL will be return and an error message will be
left at the current active Tcl interpreter (CDM_Interp).
This function will return the new Document text (as an object of type
CDM_ByteSequence) if the insertion was succesful.
The returned object is property of the CDM and should never be
freed or modified in any way by the caller. Return Value:
In case of an error, NULL will be return and an error message will be
left at the current active Tcl interpreter (CDM_Interp).
This function is equivelant to tip_ByteSequenceInsertString (Tcl API). Notes:
CDM_RawDataInsertString, CDM_ByteSequenceReplaceCharacters,
CDM_DisplaceAnnotations,
CDM_GetByteSequence, CDM_SetByteSequence,
tip_ByteSequenceInsertString
See Also:
Generated by: petasis@aias on Wed Aug 16 10:31:57 PM EEST 2006.