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$.

See Also

Mnemonics - Alphabetical Listing

Mnemonics - Group Listing