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. |
|
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. |
|
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. |
|
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.
|
GUI mapping |
Preferences > Forms > Highlight Color > Required fields highlight color |
|
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.
|
GUI mapping |
Preferences > Forms > Highlight Color > Fields highlight color |
|
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. |
|
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 |
|
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 |
|
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 |
|
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 |
|
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