DynaPDF Manual - Page 594

Previous Page 593   Index   Next Page 595

Function Reference
Page 594 of 839
PageLink2
Syntax:
SI32 pdfPageLink2(
const PPDF* IPDF, // Instance pointer
double PosX,
// X-Coordinate of bounding rectangle
double PosY,
// Y-Coordinate of bounding rectangle
double Width,
// Width of bounding rectangle
double Height,
// Height of bounding rectangle
UI32 NamedDest)
// Handle of a named destination
The function adds a page link to the current open page by using a named destination as target.
Named destinations can be used if a destination should be accessible from another PDF file. The
parameter NamedDest must be a valid handle of named destination. See CreateNamedDest() for
further information.
If the coordinate system is bottom-up the point PosX, PosY defines the lower left corner of the
bounding rectangle. If the coordinate system is top-down it defines the upper left corner.
The border of the link annotation is drawn by using the current line width, stroke color and line
dash pattern. If the link should appear without a border set the line width to zero beforehand.
When clicking on a link annotation the rectangle is highlighted, that is a simple visual effect. Several
highlight modes are supported, see SetLinkHighlightMode() for further information.
Return values:
If the function succeeds the return value is the annotation handle, a value greater or equal zero. If
the function fails the return value is a negative error code.
PageLink3
Syntax:
SI32 pdfPageLink3(
const PPDF* IPDF,
// Instance pointer
double PosX,
// X-Coordinate of bounding rectangle
double PosY,
// Y-Coordinate of bounding rectangle
double Width,
// Width of bounding rectangle
double Height,
// Height of bounding rectangle
const char* NamedDest); // Name of a named destination
The function adds a page link to the current open page by using a named destination as target. The
difference in comparison to PageLink2() is that the named destination can be defined as string.
This makes it possible to create the link, also if you don't have the required information to create the
named destination at this point. If the named destination does not exist when the file is closed then
the link does nothing. See also, CreateNamedDest().
 

Previous topic: PageLink

Next topic: PageLinkEx