Xojo Conferences
MBSOct2019CologneDE

DynaPDF Manual - Page 243

Previous Page 242   Index   Next Page 244

Function Reference
Page 243 of 766
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