MovieClip
  |
  +--xp.system.UIControl
        |
        +--xp.controls.ScrollSelectView
              |
              +--xp.controls.ScrollSelectList
                    |
                    +--xp.controls.ListBox

The ListBox component is a scrollable single- or multiple-selection list box.
A list can also display graphics, including other components.
You add the items displayed in the list by using the Values dialog box that appears when you click in the listLabels, listIcons or listData parameter fields.
To add items to the list at run time you use methods of its list items source ListBox.itemsSource. You can use the ListItemsSource.addItem() and ListItemsSource.addItemAt() methods to add items to the list. The ListBox component uses a zero-based index, where the item with index 0 is the top item displayed.
When adding, removing, or replacing list items using the ListBox or ListItemsSource class methods and properties, you may need to specify the index of the list item.
You can set the following authoring parameters for each ListBox component instance in the Property inspector or in the Component inspector:
listLabels is an array of text values that populate the label values of the listbox.
The default value is [] (an empty array).
There is no equivalent runtime property.
listIcons is an array of linkageIds that populate the icon values of the listbox.
The default value is [] (an empty array).
There is no equivalent runtime property.
listData is an array of values that populate the data of the list.
The default value is [] (an empty array).
There is no equivalent runtime property.
The list receives focus when you click it or tab to it, and you can then use the following keys to control it:

Key	Description
Alphanumeric keys	Jump to the next item that has Key.getAscii() as the first character in its label.
Control	Toggle key that allows multiple noncontiguous selections and deselections.
Down Arrow	Selection moves down one item.
Home	Selection moves to the top of the list.
Page Down
Page Up
Shift	Allows for contiguous selection.
Up Arrow	Selection moves up one item

The listBox supports a Key search or Lookup feature.
When this is enabled items are searched for when keys are pressed.
Search is based on a match between the search expression and the list items display label.
Searching is case insensitive and can be one of the following modes:
none: No key search support
first: Searching is based on a match of the last key pressed and the first letter of the list item display label incremental: Each character of the search expression that you enter causes the list to search for the first occurrence of the string that it has so far been given.
If there is no match the current search expression is cleared

Event summary for the ListBox class
The following table lists events of the ListBox class.

Event	Type	Description
xp.events.Event	change	Broadcast whenever user interaction causes the selection to change.
xp.events.ValueChangedEvent	valueChanged	Broadcast whenever user interaction causes the selection value to change.
xp.events.ItemRollOverEvent	itemRollOver	Broadcast when the pointer rolls over list items.
xp.events.ItemRollOutEvent	itemRollOut	Broadcast when the pointer rolls over and then off of list items.