Previous Next

                                                     704
          CHAPTER 8                                                              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
                                          676) is set.

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
                                          8.6.6, “Forms Data Format.”

4              GetMethod                  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.

5              SubmitCoordinates          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
                                          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.

Previous Next