Moving Back to the Form in Case of an Invalid Form Entry

If you want the user to return to the form to correct a field entry, you must indicate the item number you want the user to be returned to by calling sfm_nextitem(), specifying item_num as the number of the item on the form that you want the user to go to.

To move to a specific field in a scrollable region, you will have to make an additional call to indicate the data row and data column of the invalid field in the scrollable region. Thus, you would make the following sequence of calls:

sfm_nextitem(item_num, dfmp);

ssr_nextpos(data_row, data_col, cursrp(dfmp));

where item_num is the item number of the scrollable region on the form.

If you do not set an item to go to next, the form editor will simply go back to the field it was at when an exit was requested.