Changing the Choice List Options

You may want to change the settings of the options set for a choice list while your program is running. You should do this before the choice list is displayed. The function to change the choice list options settings is the set choice list options function, scl_opt():

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

For example, to turn off CLWRAP for the part field in the code example, call:

scl_opt(CLWRAP, OFF, fld_clistp(part_fldp));

Table 12.1: Choice List Options

Choice List Option	Action When Option is ON
CLAUTO	The system automatically sizes and places the choice list window. You do not have to specify this option; it is the default.
CLAUTOMOVE	The user is automatically advanced to the next field after a choice is made from a choice list. This may not be desirable for the first and last fields on a scrollable region or the first and last fields on a form, especially if the AUTOEXIT form 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, the cursor moves to that item. If CLCONFIRM is OFF, the item is selected and transferred to the field. When CLWRAP is ON, searching starts at the next item and wraps around and back to the current item. If CLWRAP is OFF, searching starts at the next item in the choice list and continues until the end of the list is reached.
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 Enter (or the selection key) to select the item.
CLMANUAL	You are responsible for placing and sizing the choice list window. This option has precedence over CLONFIELD if both are set ON.
CLMULTIPLE	Enables multiple selections from a single choice list. Selections are marked by a checkmark to the left of the selected item.
CLONFIELD	The choice list window covers the calling field and is the same size as the calling field. Only one choice list item is displayed at a time. The initial choice appears in the field when the choice list is first displayed; other choices can be brought into view by using the cursor keys.
CLPOP	If a choice list is installed for the field, it is automatically popped up when the user enters the field.
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.