DynaPDF Manual - Page 723
Previous Page 722 Index Next Page 724
Function Reference
Page 723 of 874
SetBookmarkDest
Syntax:
LBOOL pdfSetBookmarkDest(
const PPDF* IPDF,
// Instance pointer
SI32 ABmk,
// Bookmark handle
TDestType DestType, // see below
double a,
// Various, depends on destination type
double b,
// Various, depends on destination type
double c,
// Various, depends on destination type
double d)
// Various, depends on destination type
typedef enum
{
dtXY_Zoom,
// Three parameters (a, b, c) -> (X, Y, Zoom)
dtFit,
// No parameters
dtFitH_Top,
// One parameter
(a)
dtFitV_Left, // One parameter
(a)
dtFit_Rect,
// Four parameters (left, bottom, right, top)
dtFitB,
// No parameters
dtFitBH_Top, // One parameter
(a)
dtFitBV_Left // One parameter
(a)
}TDestType;
The function sets or changes the destination of a bookmark. The parameter ABmk must be a valid
bookmark handle. The destination page will not be changed by this function it must be set correctly
with the function AddBookmark(). If it should be changed use the function ChangeBookmark().
The destination created by this function allows jumping to a specific position in a document instead
of simply opening a page such as a normal bookmark does.
Destination types
Description
dtXY_Zoom
Display the page designated by page with the coordinates (left top) positioned at the
top-left corner of the window and the contents of the page magnified by the factor
zoom. A zero value for any of the parameters left top or zoom specifies that the
current value of that parameter is to be retained unchanged.
Example:
// The zoom factor is left unchanged
SetBookmarkDest(pdf, bmk, dtXY_Zoom, 50, 750, 0, 0);
dtFit
Display the page designated by page with its contents magnified just enough to fit
the entire page within the window both horizontally and vertically. If the required
horizontal and vertical magnification factors are different, use the smaller of the
two, centering the page within the window in the other dimension. This destination
type has no parameters, the values of a, b, c, d are ignored.
dtFitH_Top
Display the page designated by page with the vertical coordinate top positioned at
the top edge of the window and the contents of the page magnified just enough to fit
the entire width of the page within the window.
Previous topic: Bounding boxes:, SetBidiMode
Next topic: SetBookmarkStyle, SetBorderStyle