fgl_dialog_fieldorder() is used to toggle between two different sets of events that occur when moving from one field to another.
The normal behaviour is that traversing from one field to another will apply some before and some after logic for all other fields between them. This behaviour can be altered where only the after logic of the current field and the before logic of the destination field is triggered.
The field order logic refers to the before/after field logic that applies when navigating from one control to another. In simplistic terms this logic dictates an application event (e.g., a message prompt) that occurs before and after a user traverses from one field to another.
Therefore, where five fields exist, e.g., f1-f5, and field f1 is active, clicking f5 will execute the after field logic for f1 and then the before and after logic for f2, f3, f4, and then the before logic for f5. If the function is called with the Boolean value of FALSE, the application will only execute the after field logic for f1 and the before logic for f5.
This function passes a single argument, TRUE or FALSE, expressed as a SMALLINT. The default behaviour for this function is TRUE which will apply all field order logic for all fields. To only apply the field order logic for the current and destination fields, pass a parameter of ‘0’ with the function:
fgl_dialog_fieldorder(0)