DynaPDF Manual - Page 290

Previous Page 289   Index   Next Page 291

Function Reference
Page 290 of 874
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