DLI Implementation and Reference Guide - Datalogics

13.2 DLI Implementation and Reference Guide
Overview
Concepts and Facilities: Guide to the DL Pager Composition System
Pages may contain text annotations, which are notes appended to the document, and
link annotations, which indicate that an area of the page (always a rectangular area)
connects to another area of this or another document. Links to external documents
must be supported externally to this package.
The methods used for creation of annotations return the CosObj which is the
annotation. This object need not be picked up by the application, and does not need
to be deallocated by the application.
Modifying for Other Actions
The objects may be modified, either immediately after creation or at any time prior to
writing the document, to permit access to functionalities beyond those described in
these method interfaces. There are fourteen or more different annotation types, and
not all are represented by DLI methods, so in some circumstances you will need to
create an object as one type, but then modify it to be another.
Therefore, if you plan to change the annotations to perform other actions, you must
make your changes before the document is released from the resources. See following
sections of this chapter for further details.
Annotation Components
All annotations consist of two parts: a hot spot, which is defined as a rectangular area
of the page, and an action.
Hot Spots
The hot spot can be defined as an ASFixedRectangle, or as a reference to a name
contained in a special Name Tree within the document.