DLI Implementation and Reference Guide - Datalogics

Annotations and Links 13.9
Modifying the Link Cos Object
Each of the three methods which create an annotation return a CosObj. This
structure is the annotation dictionary, and may be modified freely. In practice, it is the
link annotation that will most often be modified.
As created by DLI, the link annotation dictionary will contain the following key/value
pairs:
• Type Annot
• SubType Link
• Rect [x, y, x+wide, y+depth]
• Border [v1, v2, v3] (if Border is not NULL)
• Color [r, g, b] (if Color is not NULL)
• Dest [...], where the destination is described in the array
This will create a link whose action is defaulted to “GoTo.”
Although "GoTo" is the normal state for a link within a document, there are 13
possible actions for selecting a link permitted in PDF Specification 1.2, and a
fourteenth added in PDF Specification 1.3. More may be added in the future.
In order to modify this link to use one of the other actions, you must replace the Dest
couplet with an A key and an action dictionary:
1 The Dest couplet is removed, using
CosDictRemove(Dict, ASAtomFromString (“Dest”));.
2 The action dictionary is created, always as a new, indirect, dictionary structure. It
has a Type of Action, a SubType of the action desired (See PDF Specification,
section 6.8), and additional parameters depending on the action selected.
The following is extracted from the full example of creating annotations: