DLI Implementation and Reference Guide - Datalogics

13.6 DLI Implementation and Reference Guide
From the full example of creating annotations:
"C" Example: Creating Concepts A Link and Annotation Facilities: Guide to the DL Pager Composition System
DLPDFPAGE *Page1
ASFixedRect BBLink1, PageRect;
ASFixed Border[3], Color[3];
/* Set up the border and color arrays */
Border[0] = Border[1] = 0; /* This is a square box */
Border[2] = fixedTwo; /* Two points in thickness */
Color[0] = Color[2] = 0; /* Its color will be blue */
Color[1] = fixedOne;
dlpdfpageaddlinkannotation (Page1, &BBLink1, Border,
Color, 1, "Fit", &PageRect, PDViewDestNULL);
dlpdfpageaddlinkannotationfromname
An optional structure within the PDF document is a name tree. This consists of an
ordered collection of strings (names) and a value for each name, which is an array in
the form defined in the PDF Specification, section 7.3.1. The named destination itself
is described in sections 7.3.2 and 6.9.
In the Adobe PDF Library, only the DEST name tree may be defined, and within DLI,
there is direct support only for the name tree. Names may be added to the name tree
via dlpdfdocnameadd.
Names vs. Destinations
A link may be accomplished using a name, rather than a specific destination. When
cross-document links are to be used, referring to a name permits a more flexible
linkage: if the document referred to is modified, you need not recompose the referring
documents.
In practice, this means that you would need to create a name tree which names all of
the possible interesting sites for a link, and publish the names of those sites to
potential linking documents. These names should be derived directly from the text, to