VR

"Value required" status of a form field. Indicates whether a value is required in this form field.

Valid Values

A 1-character code, as shown in the table below:

Code

Meaning

I

Immediate. This form field must be completed before focus can move elsewhere in the form

N

No. This form field need not be completed before control can return to the application program

Y

Yes. This form field must be completed before control can return to the application program on callback or scrolling events; on other events, control returns, but an incomplete required field is noted in Event system variables

Remarks

If the VR of a form field is I, and an accelerator key is pressed before the form field is assigned a valid value, an error message appears and focus returns to the form field.

If a form field has an IT setting of A and a VR setting of I, the VR setting takes precedence: the form field must be assigned a value before an event can cause a callback to the application program.

See Also

ValRule, VA