Moving to a Different Field in a Scrollable Region

If you want to move to a different field within the scrollable region, do not use sfm_nextitem(). sfm_nextitem() moves between items on a form. To move between fields in a scrollable region, use the set scrollable region next position function, ssr_nextpos():

void ssr_nextpos(data_row, data_col, srp)
 
int data_row;
/* Data row to go to in scrollable region
*/
int data_col;
/* Data column to go to
*/
SRPTR srp;
/* Scrollable region to move in
*/

For your convenience, you can use the following defined values for data_row:

AC_PREVROW To go to the previous row
AC_NEXTROW To go to the next row
AC_FIRSTROW To go to the first row
AC_LASTROW To go to the last row
AC_SAMEROW To remain in the same row

For your convenience, you can use the following defined values for data_col:

AC_PREVCOL To go to the previous column
AC_NEXTCOL To go to the next column
AC_FIRSTCOL To go to the first column
AC_LASTCOL To go to the last column
AC_SAMECOL To remain in the same column

If the user is not in the scrollable region already, you must move there first by calling sfm_nextitem() and passing the item number of the scrollable region to go to.

If you are calling ssr_nextpos() from a begin-field function, you must indicate that you still intend to remain in the same item (the scrollable region). Use the following sequence of calls:

sfm_nextitem(AC_SAMEITEM, dfmp);

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


Home Contents Previous Next