DynaPDF Manual - Page 135

Previous Page 134   Index   Next Page 136

Function Reference
Page 135 of 839
Return values:
If the function succeeds the return value is the handle of the DPart node, a value greater or equal
zero. If the function fails the return value is a negative error code.
AddFieldToFormAction
Syntax:
SI32 pdfAddFieldToFormAction(
const PPDF* IPDF, // Instance pointer
UI32 Action,
// Handle of a submit or reset form action
UI32 AField,
// Handle of a field that should be added to array
LBOOL Include)
// Include or exclude this field from submitting?
Instead of simply submitting all field values of an interactive form to a web server, it is also possible
to submit the values of specific fields only. A submit form and reset form action can hold an
optional array of fields which can be included or excluded from the action. For example, if a form
contains 20 fields which all should be submitted to the web server apart from two of those fields,
then add the two fields to the submit form action and set the parameter Include to false.
Note, that parameter Include is handled reversed if the submit flag sfExclude is set (see also
CreateSubmitAction(), CreateResetAction()). The fields are then excluded if Include is true and vice
versa.
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
AddFieldToHideAction
Syntax:
SI32 pdfAddFieldToHideAction(
const PPDF* IPDF, // Instance pointer
UI32 HideAct,
// Handle of the hide action
UI32 AField)
// Field handle
This function adds a field to a hide action. An arbitrary count of fields can be added to a hide action.
Remarks:
Acrobat 4 does not support radio buttons or group fields inside a hide action. The fields of a group
field or the check boxes of a radio button field must be added to a hide action separately. Since
Acrobat 5, group fields and radio buttons are supported too.
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
 

Previous topic: How to create DPM?

Next topic: AddFileComment, AddFontSearchPath