DynaPDF Manual - Page 256

Previous Page 255   Index   Next Page 257

Function Reference
Page 256 of 777
// Display the fonts info tab
// Display the save as dialog (requires Acrobat)
naSecurityInfo, // Display the security settings
// Fit the page into the window
// Delete one or more pages
// Quit the application
// Internal value to store unknown imported values
The function creates a named action. Only PDF 1.2 compatible actions are documented in the PDF
Reference. So, all other actions may still work but there is no guarantee that these actions will be
supported in future versions of Adobe's Acrobat or Reader. Actions must be added to a PDF object
with AddActionToObj() so that they can be executed.
Return values:
If the function succeeds the return value is the action handle, a value greater or equal zero. If the
function fails the return value is a negative error code.
SI32 pdfCreateNamedDest(
const PPDF* IPDF,
// Instance pointer
const char* Name,
// Name of the destination (byte string)
UI32 DestPage,
// Destination page
TDestType DestType, // Destination type
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
The function creates a named destination that can be accessed from external PDF files. Named
destinations are useful if the destination must be accessed from another PDF file. For example, a link
to the beginning of Chapter 3 in another document might refer to the destination by a name, such as
Chap3.begin, instead of an explicit page number in the other document. This makes it possible to
change the destination in the document without invalidating the external link that refers to the
Named destinations can be used in the same document by bookmarks, page links, and go-to actions.
This makes it possible to share named destinations with external and internal links. Named
destinations which are located in another document can be accessed with a go-to-remote action (see
CreateGoToRActionEx() for further information).
Named destinations can be defined in Ansi or Unicode format. However, the Unicode format is very
unusual and should not be used if possible because named destinations are binary strings.
The different destination types are described in detail at CreateGoToAction().

Previous topic: CreateNamedAction

Next topic: CreateNewPDF