Action Codes and Current Item Numbers

The current form item number tells the system what item on the form is being processed. Setting a tells the form editor whether it should continue the current process, start processing another item or form, or quit processing altogether.

For example, if the user aborts by pressing the Quit key, the quit function kd_quit() performs the necessary operations for form cleanup and sets the next action code to AC_QUIT. The form editor, upon reading this action code, returns to fm_rd(). fm_rd() quits reading the form and returns AC_QUIT.

The values of the next action code and current item are set by both the system event functions that the user invokes and, under certain circumstances, the form editor itself. As an example of the latter condition, the form editor sets the action code to AC_EXIT if the user presses the Next Item key when on the last field of the form and AUTOEXIT is ON. You can further control form processing by writing form, field, and event functions that set the next action code or the next item to go to in the form.


Home Contents Previous Next