DynaPDF Manual - Page 746

Previous Page 745   Index   Next Page 747

Function Reference
Page 746 of 770
aiUserDefined // Internal, not usable!
The function creates a text annotation. The parameters Width and Height define the size of the
annotation's window. The window is shown in the open state of the annotation.
If the parameter Open is true, the annotation appears in its open state when opening the document. If
the annotation is closed, the annotation's icon appears on screen.
The parameters Author and Text are optional, they can be NULL.
This function is implemented in an Ansi and Unicode compatible version. The Ansi Version
supports Ansi strings of the code page 1252 only. To create a text annotation in an arbitrary encoding
convert the string to Unicode with the function ConvToIncode()and use the Unicode version to
create the annotation.
Return values:
If the function succeeds the return value is the annotation handle, a value greater or equal zero. If the
function fails the return value is a negative error code.
LBOOL pdfTranslateCoords(
const PPDF* IPDF, // Instance pointer
double OriginX,
// New coordinate origin of the x-axis
double OriginY)
// New coordinate origin of the y-axis
The function translates the coordinate system to the new origin OriginX, OriginY. Save the graphics
state beforehand and restore it when finish.
After the coordinate system was changed by the function, bottom-up coordinates are active. It is not
possible to use top-down coordinates with a transformed coordinate system.
If the graphics state was not saved beforehand the function set a warning but the transformation will
be applied.
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0. Use an error
callback function or check whether an error occurred with the function GetErrorMessage(). See
Exception handling for further information.

Previous topic: TestGlyphs, TestGlyphsEx, TextAnnot

Next topic: TranslateRawCode (Font API)