Opens a form or display in the current window.
FORM OPEN [object][ NOCLEAR][ NOGUIUSE]
|object||name: The name of the form or display to be opened.
(expr): A character string, or an expression that evaluates to a character string, to be used at run time as the name of the form or display.
|NOCLEAR||The values currently assigned to the constituent form fields are to be retained.
If omitted, each form field value is reset to its default.
|NOGUIUSE||The current form or display is opened for internal use only and is never displayed.
It is intended for the performance improvement whenever forms are used as arrays in memory.
Any attempt to display these objects will be ignored.
Other operations are accepted as usual.
FORM OPEN command initializes a form or display for use.
The form or display is displayed using the
FORM DISPLAY command, and input is requested using the
FORM INPUT command.
The form or display specified in a
FORM OPEN command remains the current form in its window until a
FORM CLOSE, or
WINDOW CLOSE command is executed.
Each window has its own current form.
FORM OPEN command is executed, all ,em>form field attributes are reset to their defined values.
An exception is the field’s value, which is not reset if the
NOCLEAR option is used.
FORM OPEN command also establishes a form for use as an in-memory EntitySet.
When treated as an EntitySet, a standalone form has only one record.
The forms in a display have as many records as there are instances of a particular form in the display.
form open dAddEmps
Opens a display and resets all constituent form fields to their default values.
form open fAddEmps
form display input
form open fAddDepts
form open fAddEmps noclear
Opens a form and resets its field values, then displays the form and requests user input. Next, a second form is opened and displayed.
Finally, the first form is opened again, and the field values input earlier are re-displayed (because the
NOCLEAR option was specified).
form open ($ concat(" fContracts", ContractType))
Opens a certain form dynamically by type.