Monkeybread Software - DynaPDF Manual

DynaPDF Manual - Page 813

Function Reference

Page 813 of 839

aiInsert,

aiKey,

aiNewParagraph,

aiNote,

aiParagraph,

aiUserDefined // Internal, not usable!

}TAnnotIcon;

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.

Remarks:

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.