DynaPDF Manual - Page 460
Previous Page 459 Index Next Page 461
Function Reference
Page 460 of 839
GetNamedAction
LBOOL pdfGetNamedAction(
const PPDF* IPDF,
// Instance pointer
UI32 Handle,
// Action handle
struct TPDFNamedAction* Action) // see below
struct TPDFNamedAction
{
UI32
StructSize;
// Must be set to sizeof(TPDFNamedAction).
const char*
Name;
// Only set if Type == naUserDefined.
SI32
NewWindow;
// -1 = viewer default, 0 = false, 1 = true.
SI32
NextAction;
// -1 or next action handle to be executed if any.
TActionType
NextActionType; // Only set if NextAction is >= 0.
TNamedAction Type;
// Known pre-defined actions.
};
typedef enum
{
naFirstPage,
// PDF 1.2 Go to the first page of the document
naLastPage,
// PDF 1.2 Go to the last page of the document
naNextPage,
// PDF 1.2 Go to the next page
naPrevPage,
// PDF 1.2 Go to the previous page
naGoBack,
// Go back to last page and position
naOpenDlg,
// Display the file open dialog
naPrintDlg,
// Display the print dialog
naGeneralInfo,
// Display the general info tab
naFontsInfo,
// Display the fonts info tab
naSaveAs,
// Display the save as dialog (requires Acrobat)
naSecurityInfo, // Display the security settings
naFitPage,
// Fit the page into the window
naDeletePages,
// Delete one or more pages
naQuit,
// Quit the application
naUserDefined
// Internal value to store unknown imported values
}TNamedAction;
The function retrieves the properties of a Named action. The member StructSize must be set to
sizeof(TPDFNamedAction) before the function can be called.
If the application does not recognize the name, it shall take no action. Only the first four names are
defined in the PDF specs. All other pre-defined names were seen in PDF files created by Adobe's
Acrobat or Distiller.
Return Values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
Previous topic: GetMiterLimit, GetMovieAction
Next topic: GetNamedDest, GetNamedDestCount, GetNeedAppearance