Shifts the focus to the open form in the current window and puts the application user in control of the interface.
FORM INPUT [PURGE]
|PURGE||Causes unprocessed input, received before the FORM INPUT command was executed, to be ignored. Eliminates the possible affects of inadvertent keystrokes or mouse actions before the application user is actually placed in control of the interface.|
The FORM INPUT command ensures that the focus is in an available field of the current form and requests input from the application user. The application user can navigate through the available objects, enter data, interact with objects, and so on. If a scrolling relationship has been established between the form and a set of records, designated scrolling keys can be used to scroll data through the form.
The FORM INPUT command completes when an event occurs that causes a callback to the application program. If, at completion, the field that has focus contains an invalid value, the value in that field is automatically deleted.
A FORM DISPLAY command with the INPUT option or a MENU INPUT command also requests input from the application user.
The completion of FORM INPUT changes the value of the Event, ThisForm, ThisMenu, and ThisWindow system variables.