start_list
(start_list key [operation [index]])
The startlist function starts operations to manipulate list boxes and popup lists of DCL dialog boxes.
Arguments
key specifies the key of a tile being modified.
operation is an integer specifying the type of operation. Valid values are:
Operation
Mode |
Description |
1 |
Changes the content of the specified list tile. |
2 |
Appends entries to the specified list tile. |
3 |
Replaces a list with a new one starting with the specified index (default). |
index is used only when the operation argument is set to 1. It specifies the position of the element at which changing of the list starts. Index numbering begins with zero.
Return Value
The function returns the name of the list that was started.
Note: Use only the start_list function, not the set_tile function between start_list and end_list function calls.
To create a new list:
(start_list "list_tile_1")
To add new elements to a list:
(start_list "list_tile_1" 2)
To begin changing elements of a list:
(start_list "list_tile_1" 1 12)
add_list, end_list