Controlling the Display and Processing of Choice List Menus

cl_proc() displays the choice list, passes control to the user to read the choice list, and removes the choice list from the screen. To gain more control over when these processes take place, you can call the following low level functions:

int cl_up(clistp)

int cl_rd(start_item, clistp)

void cl_dn(clistp)

int cl_upd(clistp)

To display a choice list

To pass control to the user

To remove choice list from screen

To redisplay items in a choice list

The sequence of cl_up(), cl_rd(), and cl_dn() replaces the call to cl_proc(). The returns for cl_rd() are the same as cl_proc(): AC_EXIT if the user made a selection and AC_QUIT if the user left the choice list without making a selection.

cl_upd() is used to redisplay a choice list after the choice list items have been changed in some way.

Some things to remember about using these low-level functions instead of cl_proc():

• nMake all changes to the choice list window before it is displayed with cl_up(). cl_upd() does not reset the window if it is already on the screen.
  
  
• nMake sure all choice list options are set before calling cl_rd().