Xojo Developer Conference
25/27th April 2018 in Denver.
MBS Xojo Conference
6/7th September 2018 in Munich, Germany.

DynaPDF Manual - Page 239

Previous Page 238   Index   Next Page 240

Function Reference
Page 239 of 750
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.
CreateGroupField
Syntax:
SI32 pdfCreateGroupField(
const PPDF* IPDF, // Instance pointer
const char* Name, // Name of the field
SI32 Parent)
// Parent group field if any or -1
This function creates a group field. A group field is a simple array of fields which can be used to
separate fields into several groups. The field itself has no appearance, it is invisible.
 

Previous topic: CreateGoToRAction

Next topic: Field names and Group fields