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

DynaPDF Manual - Page 246

Previous Page 245   Index   Next Page 247

Function Reference
Page 246 of 750
CreateLaunchAction
Syntax:
SI32 pdfCreateLaunchAction(
const PPDF* IPDF,
// Instance pointer
TFileOP OP,
// Kind of operation (open or print the file)
const char* FileName, // File name (required)
const char* DefDir,
// Default directory (can be NULL)
const char* Param,
// Optional parameters (can be NULL)
LBOOL NewWindow)
// Open the file in a new window?
typedef enum
{
foOpen,
foPrint
}TFileOP;
A launch action launches an application or opens or prints a document. Acrobat passes the
parameters of a launch action directly to the API function ShellExecute(). The parameter FileName
can be an absolute or relative file path but relative file paths are preferred.
The parameter DefDir defines a default directory in which the file should be searched. The parameter
Param defines an optional parameter string which can be passed to the application. This parameter
should be omitted if the FileName designates a document. The parameters DefDir and Param are both
optional, they can be NULL. See also ShellExecute() of your Windows API reference for further
information.
The last parameter NewWindow specifies whether the file should be opened in a new window or not.
This parameter is ignored if the file is not a PDF file.
Remarks:
Adobe's Acrobat displays a warning before executing a launch action. Actions must be added to a
PDF object with AddActionToObj().
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.
 

Previous topic: CreateJSAction

Next topic: CreateListBox