Inserting, Removing, and Replacing Items in a Choice List

You may want to change the items in a choice list based on data that the user enters elsewhere on the form. If you change the choice list items, you must do it before the choice list is displayed or update the choice list after making the changes. Note that begin-field functions are always called before a choice list is automatically popped up or before the user can invoke a function from the keyboard.

The functions to insert, remove, and replace a choice list item are listed below:

int cli_ins(UCHAR *stp, int item_num, CLISTPTR clistp)

int cli_del(int item_num, CLISTPTR clistp)

int cli_rpl(UCHAR *stp, int item_num, CLISTPTR clistp)

The number to access any item in the choice list may be different after inserting or deleting an item. Note that changes are made to the choice list memory file, not to the keyworded text file on disk.

These functions and others that you might find useful for manipulating choice lists during form processing are discussed in more detail in Chapter 48, "Using Choice Lists as Stand-Alone Menus"