Search Locate Previous Next Contents

List Box (LS)


Description
Simple multiple selection from a scrolling list. You can choose between an index vector or a boolean mask as the most convenient way of representing your data as the selected items.

Indices – should be an integer vector of indices into Items

Selection – a boolean mask on Items (length should match Items)

Items – which is the text shown in the box (Nested text vector)

Caption (if used) makes a label directly above the list. Note the ‘toggle’ style which simulates <Ctrl> being held and the ‘multicolumn’ style which is good for long lists of short names.

Class Property Table
NameTypeDefaultDescription
HintString
SelectOneOf‘Multi’Selection strategy (‘Single’ ‘Multi’)
StyleManyOf
ItemsRuntimeItems List (listbox contents)
IndicesUserInteger vector (selected indices)
SelectionUserBoolean vector (length equal to items)
FirstRowUserFirst visible row
VisibleRuntimeBoolean singleton
ActiveRuntimeBoolean singleton

Class-specific Functions
SetTabsset tabs at distance(s) in pixels from left edge of listbox


Continue to: List Box – SetTabs Function
© Copyright Causeway Graphical Systems Ltd 2003