Monkeybread Software - DynaPDF Manual

DynaPDF Manual - Page 312

Function Reference

Page 312 of 839

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.

Flag

Description

sfNone

Use default settings. Field values are transmitted in Forms Data

format (FDF).

sfExlude

Exclude the fields in the submit form action if any. These fields must

be added to the form action with AddFieldToFormAction().

sfInclNoValFields

If set, all fields designated by the fields array of the form action are

submitted, regardless whether they have a value, only the field name

is transmitted. If no fields are added to form action this flag is applied

to all fields included in the interactive form.

sfHTML

If set, the field names and values are submitted in HTML format. If

clear, they are submitted in Forms Data Format (FDF). This flag is

meaningful only when the flag sfXML is clear; if set, this flag is

ignored.

sfGetMethod

Use HTTP GET request instead of POST.

sfSubmCoords

If set, the coordinates of the mouse click that caused the submitform

action are transmitted as part of the form data. The coordinate values

are relative to the upper-left corner of the field ’s bounding box. They

are represented in the data in the format

name.x = xval & name.y = yval

where name is the field name. This flag is meaningful only when the

sfHTML flag is set; if sfHTML is clear, this flag must also be clear.

sfXML

(PDF 1.4) If set, field names and values are submitted in XFDF format.

sfInclAppSaves

(PDF 1.4) Meaningful only when the form is being submitted in Forms

Data Format (that is, when both the sfXML and sfHTML flags are

clear). If set, the submitted FDF file includes the contents of all

incremental updates to the underlying PDF document, as contained in

the Differences entry in the FDF dictionary; if clear, the incremental

updates are not included.