DynaPDF Manual - Page 254

Previous Page 253   Index   Next Page 255

Function Reference
Page 254 of 777
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
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.
SI32 pdfCreateListBox(
const PPDF* IPDF, // Instance pointer
const char* Name, // Name of the list box
// Sort the choice values?
SI32 Parent,
// Parent group field if any or -1
double PosX,
// X-Coordinate of the list box
double PosY,
// Y-Coordinate of the list box
double Width,
// Width of the list box
double Height)
// Height of the list box
This function creates a list box. The choice values of the list box must be added with the function
AddValToChoiceField(). This function requires the field handle that was returned by this function.
If the coordinate system is bottom-up the point PosX, PosY defines the lower left corner of the list
box. If the coordinate system is top-down it defines the upper left corner.
Like all form fields, the width and height is measured incl. the line width of the border. The size of
normal vector graphics is measured without the line width; this must be taken into account when
calculating the width or height of a form field. The line width of the border is derived from the
current graphics state (see SetLineWidth()), it should be either 0, 1, 2, or 3 units (no border, thin,
medium, or thick). The border style can be changed with the functions SetBorderStyle() or

Previous topic: CreateLaunchAction

Next topic: CreateNamedAction