fgl_dialog_setfieldorder()

Syntax

fgl_dialog_setfieldorder(
   active INTEGER )

1. When active is TRUE, the field order is constrained. When active is FALSE, the field order is not constrained.

Usage

Typical applications control user input with BEFORE FIELD and AFTER FIELD blocks. In many cases the field order and the sequential execution of AFTER FIELD blocks is important in order to validate the data entered by the user. But with graphical front ends you can use the mouse to move to a field. By default the runtime system executes all BEFORE FIELD and AFTER FIELD blocks of the fields used by the interactive instruction, from the origin field to the target field selected by mouse click. If needed, you can force the runtime system to ignore all intermediate field triggers, by calling this function with a FALSE attribute.

This function must be called outside interactive dialog blocks, typically at the beginning of the program.

Consider using the Dialog.fieldOrder parameter when all programs are affected. The FGLPROFILE profile entry is the default when the fgl_dialog_setfieldorder() function is not used.

Consider using OPTIONS FIELD ORDER FORM for new developments with graphical rendering.