DLI Implementation and Reference Guide - Datalogics

Annotations and Links 13.7
identify them by their relevance to the context, rather than their position within the
document.
For example, you might create a name of "Maintaining Backup Files," rather than
"Chapter 2," using the text of the title rather than its sequential position, so you can
preserve the link even if the document chapters are later reorganized.
This method is intended to permit linkages by names within a document. Making a
link between documents is fairly straightforward:
• The first 4 parameters are the same as the previous two methods.
• The fifth parameter is a string giving the name of the destination.
From the full example of adding annotations:
"C" Example: Creating A Link To A Named Destination
DLPDFPAGE *Page2
ASFixedRect BBLink2;
ASFixed Border[3], Color[3];
Border[0] = fixedFive; /* A box with elliptical corners */
Border[1] = fixedTen; /* longer horizontal than vert. */
Border[2] = fixedTwo; /* Two points in thickness */
Color[0] = Color[2] = 0; /* Its color will be black */
Color[1] = 0;
dlpdfpageaddlinkannotationfromname (Page2, &BBLink2,
Border, Color, "Link1");
dlpdfpageaddwebannotation
This procedure supports adding a link structure which is identical in appearance to a
link annotation, but which references a URI (Uniform Resource Indicator, equivalent
to a URL) passed as the last character string. This method is used to place hyperlinks
to external documents, on the World Wide Web for example, within a PDF document.
NOTE: You should have your internet browser running before calling this
procedure or you may receive a “browser is busy” error. Your browser can be
specified in Acrobat via File->Preferences->Weblink.