DLI Implementation and Reference Guide - Datalogics

13.4 DLI Implementation and Reference Guide
dlpdfpageaddtextannotation
The simplest annotation in PDF is a text annotation. This appears as a “sticky note”
Concepts and Facilities: Guide to the DL Pager Composition System
in Adobe Acrobat or Adobe Reader and can be opened to display a text message.
• The first parameter is a pointer to the page which will contain this annotation.
• The second parameter is a pointer to an ASFixedRectangle whose upper left
corner will be the upper left corner of the closed annotation.
• The third is a pointer to a border specification.
• The fourth is a pointer to a color specification.
• The fifth is a pointer to a string, which will be used as a title of the opened
annotation. This may be a NULL pointer.
• The sixth parameter is a pointer to a string which is the content of this annotation.
If this is a NULL pointer, the method will raise an exception (genErrBadParm).
• Finally, the seventh parameter is a flag. If TRUE, then this annotation will be open
when first displayed. If FALSE, it will be closed.
From the full example of creating annotations:
"C" Example: Creating Text Annotations
DLPDFDOC *Doc;
DLPDFPAGE *Page1, *Page2;
ASFixedRect NoteRect;
ASFixed Border[3], Color[3];
dlpdfpageaddtextannotation (Page1, &NoteRect, Border,
Color, "Page 1 Note",
"This is a closed note placed on page one", FALSE);
dlpdfpageaddtextannotation (Page2, &NoteRect, Border,
Color, "Page 2 Note",
"This is an open note placed on page Two", TRUE);
dlpdfpageaddlinkannotation
This is the most frequently used annotation. It links an area of the page which
contains this annotation to a separate area on that or another page. The viewer uses