DynaPDF Manual - Page 272

Previous Page 271   Index   Next Page 273

Function Reference
Page 272 of 839
Remarks:
The path to the external PDF file should be defined as relative path. Actions must be added to a PDF
object with AddActionToObj(). This function is also implemented in a wide version that accepts an
Unicode file path. However, Unicode file path are supported since PDF 1.7 (Acrobat 8). Earlier
Acrobat versions will fail to open the file if the path contains non-Ansi characters.
Return value:
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.
CreateGoToRActionEx
Syntax:
SI32 pdfCreateGoToRActionEx(
const PPDF* IPDF,
// Instance pointer
const char* FileName, // File path to another PDF file
char* DestName,
// Named Destination to access
LBOOL NewWindow)
// If true, the file is opened in a new window
The function creates a go-to-remote action that opens a named destination in an external PDF file.
The parameter DestName must be the name of a named destination located in the external PDF file.
Note that this is a binary string which must be specified exactly and case-sensitive. If the name was
originally defined as an Unicode string, the go-to remote action must use the same string format.
Otherwise the destination cannot be found. See also CreateNamedDest().
Remarks:
The path to the external PDF file should be defined as relative path. Actions must be added to a PDF
object with AddActionToObj(). This function is also implemented in a wide version that accepts an
Unicode file path (CreateGoToRActionExU()). However, Unicode file path are supported since PDF
1.7 (Acrobat 8). Earlier Acrobat versions will fail to open the file if the path contains non-Ansi
characters.
Return value:
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.
 

Previous topic: CreateGoToRAction

Next topic: CreateGroupField, Field names and Group fields