DynaPDF Manual - Page 691

Previous Page 690   Index   Next Page 692

Function Reference
Page 691 of 839
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.
 

Previous topic: Bounding boxes:, SetBidiMode

Next topic: SetBookmarkStyle, SetBorderStyle