Data form options are #defined in vv_form.h. The names of the options and a description of each are presented in Table 16.1. The default for data forms is to have AUTOEXIT, AUTOMOVE, and VERIFYQUIT turned ON. All other options are set OFF.
Table 16.1: Data Form Options
| Option | Action When Option is ON |
| AUTOEXIT | When the user moves forward from the last field on the form, the form is exited. This is equivalent to pressing the Exit key. When both AUTOEXIT and FMWRAP are set, FMWRAP overrides the AUTOEXIT setting. |
| AUTOMOVE | When the field is full and the user enters a printable character in the last position of the field, the user is automatically moved to the next item. |
| CURSORCROSS, CURSORFREE |
Setting these options only affects the behavior of the arrow keys. CURSORCROSS controls behavior of Right Arrow and Left Arrow; CURSORFREE determines whether layout order or processing order is followed. Pressing Tab and Enter always cause the user to follow processing order. |
| Both OFF: Pressing Up Arrow and Down Arrow move the user through the form in processing order. Pressing Right Arrow and Left Arrow cause the user to stay within the field. (This is the default.) | |
| Both ON: Pressing all arrow keys causes the user to move in layout order. Once pressing Right Arrow or Left Arrow causes the user to hit the boundary of the field, pressing Right Arrow or Left Arrow again causes the user to continue in layout order. | |
| CURSORCROSS OFF, CURSORFREE ON: Pressing Up Arrow and Down Arrow causes the user to move in layout order. Pressing Right Arrow and Left Arrow causes the user to stay within the field. | |
| CURSORCROSS ON, CURSORFREE OFF: Up and Down Arrow keys follow processing order. Once the Right or Left Arrow key hits the boundary of the field, it will continue in processing order. | |
| FLDCHSELECT | When this option is ON, it allows the programmer to specify a selection character for each field on the form. When the user presses the Alt key (by default) in combination with a selection character that is associated with a field, that field is immediately selected |
| FMALTERED | Forces data conversion during run-time. Use this option to override normal operation. |
| FMVALID | Disables data validation during run-time. Use this option to override normal operation. |
| FMLINKSHOW | When several forms are linked and this option is OFF for a form, that form disappears from the screen when the next or previous form in sequence is put up. If this option is ON, that form remains on the screen when the next or previous form is put up. |
| FMWRAP | When moving down from the last item on a form, the cursor moves back up to the first item on the form. Likewise, when moving up from the first item on a form, the cursor will move to the last item on the form. Data field processing order is followed. |
| VERIFYEXIT | The user must confirm that exiting from the form is intended. If the user exits the form, data that he has entered is saved. |
| VERIFYQUIT | The user must confirm that quitting from the form is intended. If the user quits the form, data that has been entered is not saved |
Setting Form Options for Individual Forms
Setting Free-Form Cursor Movement
Setting Common User Access (CUA) Standard Cursor Movement
Setting Field Selection Characters
Changing the Default Form Option Settings
