LISTBOX

Syntax

ctl[n]: LISTBOX(Class Specific Properties), Other Properties

Description

Listboxes are good for scrollable lists. If you need the "pull-down menu"-style, use the COMBOBOX class. The items in the listbox are specified in the text string separated with the new line escape sequence (\n) and each item has its individual value.

Class Specific Properties

DISABLENOSCROLL

Used in conjunction with HSCROLL or VSCROLL; if the item amount is less than needed to require scrolling, the scrollbar is disabled and not removed.

HSCROLL

If necessary, a horizontal scrollbar is activated.

INTEGRALHEIGHT

The height of the listbox is resized according to the items' height. (default)

MULTICOLUMN

Items are arranged in columns (also depends on Size-property)

NOINTEGRALHEIGHT

The height of the listbox is resized according to the Size property, even if items are partially displayed.

SORT

Sorts the items in alphabetical order. The values of the items are recomputed; top item is always 0 and continues with 1, 2, etc.

VSCROLL

If necessary, a vertical scrollbar is activated.

Other Properties

Text

Defines the listbox's text contents (default = no Text)

Val

Assigns a value to the listbox and activates the item (default = -1)

Example

ctl[0]: LISTBOX, "Multiply\nScreen\nLighten\nDarken"
ctl[1]: LISTBOX(NOINTEGRALHEIGHT), "Uno\nDos\nTres\nCuatro\nCinco", Val=2, Size=(40,30)

Also see

COMBOBOX

Comments

Everyone can add his comments about his experiences with this function here. Tips for using it are welcome, too.