Enterprise Toolkit | Macintosh Plist Reference

FormPrefs (Form Preferences)

Form preferences control the behavior and appearance of PDF form.


This preference category contains the following subfeature(s):

Form Preferences

Summary table
AutoFill Locks the auto-fill functionality on or off and disables the corresponding user interface item.
IgnoreDataSchema Specifies whether all data in a form is saved rather than only data related to the form's schema.
Supported on WindowsSupported on MacSupported by AcrobatSupported by Adobe Reader
Data type 0 (bool)
Default null
Version # 8.0-9.0
Lock Path FeatureLockDown
Summary Locks the auto-fill functionality on or off and disables the corresponding user interface item.
Details Possible values include:
  • 0: Disable and lock auto-fill.
  • 1: Enable and lock auto-fill.
GUI mapping Preferences > Forms > Auto Complete drop down list.
Supported on WindowsSupported on MacSupported by AcrobatSupported by Adobe Reader
Data type 0 (bool)
Default null
Version # 8.0+
User Path FormsPrefs
Lock Path FeatureLockDown
Summary Specifies whether all data in a form is saved rather than only data related to the form's schema.
Details Possible values include:
  • null: Save form data even when it's not part of a schema.
  • 1: Save only form data that's part of the schema.
GUI mapping N/A

Forms Highlight Color

Specifies the color for borders, general fields, and required fields. Alternate colors are often specified in accessible environments.

Summary table
data The default color for required fields in forms.
data The default color for regular fields in forms.
RuntimeHighlight Specifies whether to show a field border color on hover.
Supported on WindowsSupported on MacSupported by AcrobatSupported by Adobe Reader
Data type 6 (binary)
Default Varies.
Version # 8.0+
User Path FormsPrefs\RequiredFieldHLColor
Lock Path Not lockable
Summary The default color for required fields in forms.
Details The values are a binary representation of the color. The best way to configure this preference is through the UI. Once you set via the UI, you can copy the value for use in a configuration/deployment scenario. Possible values include any system color. Specific colors are often selected to improve accessibility.
  • Varies: Set as desired.
GUI mapping Preferences > Forms > Highlight Color > Required fields highlight color
Supported on WindowsSupported on MacSupported by AcrobatSupported by Adobe Reader
Data type 6 (binary)
Default Varies.
Version # 8.0+
User Path FormsPrefs\cRuntimeBGIdleColor
Lock Path Not lockable
Summary The default color for regular fields in forms.
Details The values are a binary representation of the color. The best way to configure this preference is through the UI. Once you set via the UI, you can copy the value for use in a configuration/deployment scenario. Possible values include any system color. Specific colors are often selected to improve accessibility.
  • Varies: Set as desired.
GUI mapping Preferences > Forms > Highlight Color > Fields highlight color
Supported on WindowsSupported on MacSupported by AcrobatSupported by Adobe Reader
Data type 0 (bool)
Default 1
Version # 8.0+
User Path FormsPrefs\cRuntimeBGIdleColor
Lock Path Not lockable
Summary Specifies whether to show a field border color on hover.
Details Possible values include:
  • 0: Disables field border hover color.
  • 1: Shows a border on field hover.
GUI mapping Preferences > Forms > Highlight Color > Show border hover color for fields

Auto Complete

Enables the application to automatically complete some form fields entries so that filling form fields requires fewer keystrokes. The feature offers both basic and advanced options.

The basic auto-complete feature stores the information you enter into form fields and uses these entries to suggest relevant choices as you type into a field. Once you enter a character into a field, a drop-down box displays a list of only the most probable matches. Double-click or press Down Arrow in an empty field to display an even larger list of possible. The basic option enables the following:

  • bInlineAutoComplete
  • bRecordNewEntries
  • bUserAskedToEnableAutoComplete
The advanced auto-complete feature stores the information you enter into form fields and uses these entries to suggest relevant choices as you type into a field. If there are probable matches for a field, tabbing into that field will automatically display a list of them. If there is a very probable match, it will be entered in the field automatically. Pressing Tab while the pointer is over an entry in the list chooses the entry and moves to the next field.

The advanced options enable the following:
  • bInlineAutoComplete
  • bRecordNewEntries
  • bUserAskedToEnableAutoComplete
  • bAutoCompleteOnTab

Summary table
AutoCompleteOnTab Specifies whether to auto complete form field entries on a tab key action.
FocusRect Specifies whether to surround a field with a rectangle when it has focus.
InlineAutoComplete Specifies whether to auto complete a field based on remembered values when a user starts typing.
RecordNewEntries Specifies whether to remember form field entries for use with future auto-complete actions.
RuntimeHighlight Specifies whether to highlight fields during data entry.
StoreNumericEntries Specifies whether to store user entered numeric values.
UserAskedToEnableAutoComplete Specifies whether the user is asked to enable auto complete at runtime.
Supported on WindowsSupported on MacSupported by AcrobatSupported by Adobe Reader
Data type 0 (bool)
Default 0
Version # 8.0+
User Path FormsPrefs
Lock Path Not lockable
Summary Specifies whether to auto complete form field entries on a tab key action.
Details This option is enabled when the Advanced option is selected. Possible values include:
  • 0: Don't auto complete on tab.
  • 1: Auto complete on tab.
GUI mapping Preferences > Forms > Auto-Complete > Advanced
Supported on WindowsSupported on MacSupported by AcrobatSupported by Adobe Reader
Data type 0 (bool)
Default 0
Version # 8.0+
User Path FormsPrefs
Lock Path Not lockable
Summary Specifies whether to store user entered numeric values.
Details This option is enabled for both the Basic and Advanced options. Possible values include:
  • 0: Don't store numeric entries.
  • 1: Do store numeric entries.
GUI mapping Preferences > Forms > Auto-Complete > Remember numerical data
Supported on WindowsSupported on MacSupported by AcrobatSupported by Adobe Reader
Data type 0 (bool)
Default 1
Version # 8.0+
User Path FormsPrefs
Lock Path Not lockable
Summary Specifies whether to surround a field with a rectangle when it has focus.
Details Possible values include:
  • 0: Don't show a rectangle.
  • 1: Do show a rectangle.
GUI mapping N/A
Supported on WindowsSupported on MacSupported by AcrobatSupported by Adobe Reader
Data type 0 (bool)
Default 0
Version # 8.0+
User Path FormsPrefs
Lock Path Not lockable
Summary Specifies whether to auto complete a field based on remembered values when a user starts typing.
Details This option is enabled for both the Basic and Advanced options. Possible values include:
  • 0: Don't auto complete.
  • 1: Do autocomplete.
GUI mapping Preferences > Forms > Auto-Complete > Basic|Advanced
Supported on WindowsSupported on MacSupported by AcrobatSupported by Adobe Reader
Data type 0 (bool)
Default 0
Version # 8.0+
User Path FormsPrefs
Lock Path Not lockable
Summary Specifies whether to remember form field entries for use with future auto-complete actions.
Details This option is enabled for both the Basic and Advanced options. Possible values include:
  • 0: Don't remember entries.
  • 1: Do remember entries.
GUI mapping Preferences > Forms > Auto-Complete > Basic|Advanced
Supported on WindowsSupported on MacSupported by AcrobatSupported by Adobe Reader
Data type 0 (bool)
Default 1
Version # 8.0+
User Path FormsPrefs
Lock Path Not lockable
Summary Specifies whether to highlight fields during data entry.
Details Possible values include:
  • 0: Don't highlight fields.
  • 1: Do highlight fields.
GUI mapping N/A
Supported on WindowsSupported on MacSupported by AcrobatSupported by Adobe Reader
Data type 0 (bool)
Default 0
Version # 8.0+
User Path FormsPrefs
Lock Path Not lockable
Summary Specifies whether the user is asked to enable auto complete at runtime.
Details This option is enabled for the Advanced option. Possible values include:
  • 0: Don't ask the user.
  • 1: Do ask the user.
GUI mapping Preferences > Forms > Auto-Complete > Advanced

Forms Email Submission

These preferences specify email forms submission behaviors.

Summary table
EmailClientSelection Specifies the email client to use when submitting an XFA form.
Supported on WindowsSupported on MacSupported by AcrobatSupported by Adobe Reader
Data type 1 (int)
Default tbd
Version # 8.0+
User Path FormsPrefs
Lock Path Not lockable
Summary Specifies the email client to use when submitting an XFA form.
Details TBD
GUI mapping The dialog that appears on an email form submit.