List Button Controls


The list button control allows the user to select an item from a list. Unlike the list edit control, it does not allow a value to be entered manually. As the user types, the first matching selection in the list is placed in the edit area. Various keys may be used to navigate in the list including the Home (first selection), End (last selection), Page Up and Page Down, and arrow keys.

The list of choices available for list controls may be modified only under program control. Values in the list may be accessed using a zero based list index integer.

Creating

Mnemonic

Description

'LISTBUTTON'

Create a List Button Control

Manipulating

Mnemonic

Description

'LISTADD'

Add List Item

'LISTCLR'

Clear List

'LISTDEL'

Delete List Item

'LISTRESUME'

Resume List Updates

'LISTSEL'

Select List Item

'LISTSUSPEND'

Suspend List Updates

'LISTUNSEL'

Deselect List Item

Querying

CTRL() Function

Information Returned

0

Outer rectangle of the control in current scaled units.

1

ext of selected items, delimited by $0A$ (but no final $0A$).

2

Indices of all selected items.

3

Number of selected items followed by the total number of items in the list.

4

Control class and type.

7

Text of all items with ($0A$) after each paragraph, including the last item.

8

Visible/invisible and enabled/disabled status of the control.

15

Background color of the control.

16

Foreground color of the control.