LISTADD Mnemonic - Add List Item
Syntax
Syntax (1)
'LISTADD'(id,item_index,item${,item$...})
Syntax (2) 'LISTADD'(id,item_index,item_count),ITEMS$
Description
The 'LISTADD' mnemonic adds one or more items to the list in list box,
list button, and list edit controls before the indicated index. Use an
item_index value of 0 to add
items to an empty list or to display the list in reverse order. Use an
item_index value of -1 to add
items to the end of an existing list.
If the list is a list button or a list edit and if Syntax
(1) is used and the items are inserted at the beginning of the
list, then the first item will be displayed in the list before the drop
down button is clicked.
If Syntax (2) is used on list buttons
or list edits and the items are inserted at the beginning of the list,
then the list will not display an item until the drop down button is clicked
and an item is selected.
Parameter |
Description |
id |
Control ID number that must be an integer between 1 and 32767. |
item_index |
Adds items before or at the end of an existing list. |
item |
A string value terminated by $0A$. |
item_count |
Number of $0A$-terminated items to accept directly from the channel. |
ITEMS$ |
A list of values terminated by $0A$. |