Function tip_DisplaceAnnotation


Prototype: tip_DisplaceAnnotation(Annotation);
Arguments:

Annotation: The Annotation to be displaced (CDM_Annotation)
offset: A character offset after which all offsets are modified (long)
displacement: The number of characters that offsets will be moved (long)

C++ API Sections
Tcl API Sections
Description
Return Value
Notes
See Also
Index

Description:

This function displases or "moves" the specified Annotation by "displacement" characters. This function will iterate over all spans contained in the Annotation. For each span all the offsets contained in it (either start or end) will be examined: if any of this offsets is equal or greater than the value specified through the "offset" parameter, then the value of the "displacement" parameter will be added to it.

Return Value:

The return value from this function will be a new Annotation object, if any displacement happened.

If no displacement occured, then the specified Annotation through the "Annotation" parameter will be returned.

Finally, in case of an error, the empty string will be returned and a message will be left at the current interpreter.

Notes:

This function is equivelant to CDM_DisplaceAnnotation (C++ API).

See Also:

tip_DisplaceAnnotations, CDM_DisplaceAnnotation


Generated by: petasis@aias on Wed Aug 16 10:31:45 PM EEST 2006.