SECTION 8.6
721
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
array
(Required)
A named page reference dictionary (see Table 8.100) specifying the
location of the template.
(Optional)
An array of references to FDF field dictionaries (see Table 8.96 on
the field hierarchy).
(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
.
Fields
Rename
boolean
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
TABLE 8.100 Entries in an FDF named page reference dictionary
KEY
TYPE
VALUE
Name
F
string
file specification
(Required)
The name of the referenced page.
(Optional)
The file containing the named page. If this entry is absent, it is
assumed that the page resides in the associated PDF file.