DLI Implementation and Reference Guide - Datalogics

13.8 DLI Implementation and Reference Guide
dlpdfdocnameadd
This method allows the user to add one destination to the name tree structure, the
Concepts and Facilities: Guide to the DL Pager Composition System
optional ordered list of names and destinations.
The method accepts four parameters:
• The first is a handle for the document in which the name is to reside.
• The second is a string representing the tree name (can be NULL).
• The third is a string containing the destination name.
• The fourth is a COS structure, which must be an array with contents as described in
the PDF Specification, section 7.3.1.
"C" Example: Creating A Named Destination
/* Create a Destination structure to fit a given rectangle to
* the viewer window */
Dest = CosNewarray (Doc, TRUE, 6);
CosArrayPut (Dest, 0, Page); /* The current page */
CosArrayPut (Dest, 1, CosNewName (Doc, FALSE,
ASAtomFromString (“FitR”)));
CosArrayPut (Dest, 2, CosNewFixed (Doc, FALSE, Left));
CosArrayPut (Dest, 3, CosNewFixed (Doc, FALSE, Bottom));
CosArrayPut (Dest, 4, CosNewFixed (Doc, FALSE, Right));
CosArrayPut (Dest, 5, CosNewFixed (Doc, FALSE, Top));
dlpdfdocnameadd (Doc, "Name Tree", "Destination Name",
Dest);
dlpdfdocnamefind
This method will return the Cos structure associated with a destination name. If that
name does not exist, a CosNull structure will be returned.
The method accepts two parameters:
• a document handle
• a string containing the desired name