FORM DISPLAY

Displays some or all of the form fields of the currently open form or display in the current window.

Syntax

FORM DISPLAY [ «option»] [ «object»]

Parameters

option

Can be
BELL
Sounds the terminal bell when the FORM DISPLAY command is executed. On older machines, the PC bell is rung. Newer machines must be equipped with a sound card and speakers in order for you to hear the bell.
INPUT
Shifts focus to the form and puts the application user in control of the interface after the FORM DISPLAY command is executed.
NOCLEAR
Prevents the contents of the window from being cleared before the FORM DISPLAY is carried out. Otherwise, the current window is cleared automatically.
NOLABEL
Prevents the contents of the current window from being cleared, and displays all specified fields that contain a visible value.
NOVAR
Prevents the contents of the current window from being cleared, and displays all specified fields that have no visible value.
PURGE
Specifies unprocessed input received before the form was displayed is to be ignored. Eliminates the possible effects of inadvertent keystrokes or mouse actions.

object

Can be
form
The name of the currently open form or display. Specify a particular instance of a form in brackets beside the object's name.
formfield
The name of a particular form field within the currently open form or display. Specify a particular instance of a form field in brackets beside the form field's name.
([exp1 ],[exp2 ],[exp3 ])
Positive integers or expressions that evaluate to positive integers, that identify a particular form or form field. Exp1 identifies the form number; exp2, the field number; exp3, the instance of the form or form field in the display. At a minimum, either exp1 or exp2 must be specified.

Comments

The current window must be activated (WINDOW ACTIVATE) for the displayed objects to be visible.

FORM DISPLAY displays form fields with values as they exist at the time the command is executed. If the application program changes the value of a field, the field must be re-displayed if the application user is to see the change.

A masked field that has no data value is displayed without the mask if the field is unavailable to the application user (i.e., protected or guarded). The mask of such a field is shown or suppressed when its availability changes (as a result of the FORM SET command).

Example

form display fGrandTot fInvItem.InvItemTot

Redisplays all fields of one form, and one field of another form.

form display input bell (2,,5)

Sounds the bell while re-displaying all form fields in the fifth instance of form number 2.

Name of the application directory in which the specified object can exist. If the dirname is omitted, the object can be created in any number of directories.

 

Related Topics