DynaPDF Manual - Page 280

Previous Page 279   Index   Next Page 281

Function Reference
Page 280 of 839
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.
CreateLaunchActionEx
Syntax:
SI32 pdfCreateLaunchActionEx(
const PPDF* IPDF,
// Instance pointer
const char* FileName, // Should be a relative path
LBOOL NewWindow)
// Meaningful for PDF files only
The function creates a launch action. This type of a launch action can be used to open an arbitrary
file or application on the users system. It supports no parameters like CreateLaunchAction() but it is
also available in an Unicode compatible version. Unicode paths are supported since PDF 1.7
(Acrobat 8 or higher).
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, CreateLaunchAction

Next topic: CreateListBox