Setting the Choice List Options

There are three options available for choice list menus. They are listed in Table 48.1.

Set the choice list options before you process a choice list using cl_proc(). You can change the options for a choice list during the program as long as you do it before processing the choice list. The function to change the choice list option settings is scl_opt():

`void scl_opt(options, state, clistp)`
`int options;`	`/* Options to change to specified state`	`*/`
`int state;`	`/* State to switch options to, ON or OFF`	`*/`
`CLISTPTR clistp;`	`/* Choice list to change options for`	`*/`

Table 48.1: Choice List Menu Options

Choice List Option	Action When Option is ON
CLCHSELECT	First character selection of choice list items is enabled. When a character is typed by the user that matches the first character of one of the choice list items, that item is selected. When CLWRAP is ON, searching starts at the current item and wraps back to the current item. If CLWRAP is OFF, searching starts at the current item in the choice list and stops at the bottom of the list.
CLCONFIRM	When first character selection is also ON, first character selection only makes the appropriate item current, it does not select it. The user must press the Selection key to select the item.
CLWRAP	When moving down from the last item in a choice list, the cursor will move to the first item. Likewise, when moving up from the first item, the cursor will move to the last item.

For example, to turn ON first character selection and confirmation of first character selection, call:

scl_opt(CLCHSELECT | CLCONFIRM, ON, clistp);