DynaPDF Manual - Page 813

Previous Page 812   Index   Next Page 814

Function Reference
Page 813 of 839
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.
PosX / PosY represents always the upper left corner of the annotation, independent of the used
coordinate system. This is different in comparison to all other annotations because text annotations
are never scaled or rotated with a page. The upper left corner of the scaled bounding box is the
reference point on which the icon is rendered. Therefore, this is the only stable point at different
zoom factors.
If the parameter Open is true, the annotation appears in its open state when opening the document.
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.

Previous topic: TestGlyphs, TestGlyphsEx, TextAnnot

Next topic: TranslateCoords, TranslateRawCode (Font API)