DynaPDF Manual - Page 125

Previous Page 124   Index   Next Page 126

Function Reference
Page 125 of 787
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: AddDeviceNSeparations, Encoding of Colorant Names

Next topic: AddFileComment, AddFontSearchPath

Start Chat