CHAPTER 8
704
Interactive Features
TABLE 8.86 Flags for submit-form actions
BIT POSITION
NAME
MEANING
1
Include/Exclude
If clear, the
Fields
array (see Table 8.85) specifies which fields to
include in the submission. (All descendants of the specified fields in
the field hierarchy are submitted as well.)
If set, the
Fields
array tells which fields to exclude. All fields in the
document’s interactive form are submitted
except
those listed in the
Fields
array and those whose NoExport flag (see Table 8.70 on page
2
IncludeNoValueFields
If set, all fields designated by the
Fields
array and the Include/
Exclude flag are submitted, regardless of whether they have a value
(
V
entry in the field dictionary). For fields without a value, only the
field name is transmitted.
If clear, fields without a value are not submitted.
3
ExportFormat
Meaningful only if the SubmitPDF and XFDF flags are clear. If set,
field names and values are submitted in HTML Form format. If
clear, they are submitted in Forms Data Format (FDF); see Section
If set, field names and values are submitted using an HTTP GET
request. If clear, they are submitted using a POST request. This flag
is meaningful only when the ExportFormat flag is set; if ExportFor-
mat is clear, this flag must also be clear.
If set, the coordinates of the mouse click that caused the submit-
form action are transmitted as part of the form data. The coordinate
values are relative to the upper-left corner of the field’s widget an-
notation rectangle. They are represented in the data in the format
name
. x =
xval
&
name
. y =
yval
4
GetMethod
5
SubmitCoordinates
where
name
is the field’s mapping name (
TM
in the field dictionary)
if present; otherwise,
name
is the field name. If the value of the
TM
entry is a single space character, both the name and the dot follow-
ing it are suppressed, resulting in the format
x =
xval
& y =
yval
This flag is meaningful only when the ExportFormat flag is set. If
ExportFormat is clear, this flag must also be clear.