Older Newer
Mon, 31 Mar 2003 09:24:35 . . . . SyneRyder


Changes by last author:

Added:
= 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 ==

<code>

ctl[0]: LISTBOX, "Multiply\nScreen\nLighten\nDarken"

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

</code>

== Also see ==

:COMBOBOX

== Comments ==

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