User Guide

761
27
CHAPTER 27
List component
The List 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 labels or data parameter fields. You can
also use the
List.addItem() and List.addItemAt() methods to add items to the list.
The List 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 List class methods and
properties, you may need to specify the index of the list item.
The list receives focus when you click it or tab to it, and you can then use the following keys
to control it:
For more information about controlling focus, see “FocusManager class” on page 721 or
“Creating custom focus navigation” in Using Components.
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 Selection moves down one page.
Page Up Selection moves up one page.
Shift Allows for contiguous selection.
Up Arrow Selection moves up one item.
NOTE
The page size used by the Page Up and Page Down keys is one less than the number of
items that fit in the display. For example, paging down through a ten-line drop-down list
shows items 0-9, 9-18, 18-27, and so on, with one item overlapping per page.