Programmer Guide/Shell Items/Dialog/Dialog Controls/Listbox

SET dialog index LISTBOX row col text var1 width height var2 [fg bg font] [ /Table [ /X ]][ /A|L|R ]

With commands containing the option /Read, the selection status is copied to the tag flags of the table entries, but the entry content remains unchanged. Dialog commands with the option /Write write both table data and selection status to the control. Table entries are displayed in show format (see the SET TABLE CONFIG command in Configuring a table field).

var1	The name of the variable to store the index or the counter in.
var2	The name of a table item (/Table) or variable containing a blank separated list of items.
/Table	You must specify this option if var2 is the name of a table containing the list items.
/X	The option /X stands for eXtended selection. Multiple items may be selected, and var1 is set to the number of selected items. This option is only applicable with the /Table option. If this option is not specified, only one item may be selected and, var1 contains the index of the selected item.

See Common arguments for a description of the parameters not described here.