DynaPDF Manual - Page 268

Previous Page 267   Index   Next Page 269

Function Reference
Page 268 of 839
CreateGoToAction
Syntax:
SI32 pdfCreateGoToAction(
const PPDF* IPDF,
// Instance pointer
TDestType DestType, // Destination type
UI32 PageNum,
// Destination page
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;
A go-to action changes the view to a specific destination (page, location, and magnification factor).
This action type is useful if a specific destination must be used by several objects such as bookmarks
and page links.
Destination type
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:
pdfCreateGotoAction(pdf, dtXY_Zoom, 1, 0, 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: CreateGeospatialMeasure

Next topic: CreateGoToActionEx, CreateGoToEAction