Previous Next

                                                       721
         SECTION 8.6                                                                Interactive Forms



         An FDF template dictionary contains information describing a named page that
         serves as a template. Table 8.99 shows the contents of this type of dictionary.

                               TABLE 8.99 Entries in an FDF template dictionary
KEY          TYPE               VALUE

TRef         dictionary         (Required) A named page reference dictionary (see Table 8.100) specifying the
                                location of the template.

Fields       array              (Optional) An array of references to FDF field dictionaries (see Table 8.96 on
                                page 717) describing the root fields to be imported (those with no ancestors in
                                the field hierarchy).

Rename       boolean            (Optional) A flag specifying whether fields imported from the template may be
                                renamed in the event of name conflicts with existing fields; see below for further
                                discussion. Default value: true.

         The names of fields imported from a template may sometimes conflict with those
         of existing fields in the target document. This can occur, for example, if the same
         template page is imported more than once or if two different templates have fields
         with the same names. If the Rename flag in the FDF template dictionary is true,
         fields with such conflicting names are renamed to guarantee their uniqueness. If
         Rename is false, the fields are not renamed; this results in multiple fields with the
         same name in the target document. Each time the FDF file provides attributes for
         a given field name, all fields with that name are updated. (See implementation
         notes 137 and 138 in Appendix H.)

         The TRef entry in an FDF template dictionary holds a named page reference
         dictionary describing the location of external templates or page elements. Table
         8.100 shows the contents of this type of dictionary.

                     TABLE 8.100 Entries in an FDF named page reference dictionary
KEY       TYPE                     VALUE

Name      string                   (Required) The name of the referenced page.

F         file specification       (Optional) The file containing the named page. If this entry is absent, it is
                                   assumed that the page resides in the associated PDF file.

Previous Next