MACROMEDIA FLASH MX 2004-USING COMPONENTS Use Manual page 449

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()
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:
Key
Alphanumeric keys
Control
Down Arrow
Home
Page Down
Page Up
Shift
Up Arrow
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 will show items 0-
9, 9-18, 18-27, and so on, with one item overlapping per page.
For more information about controlling focus, see
on page 50 or "FocusManager class" on page
A live preview of each List instance on the Stage reflects changes made to parameters in the
Property inspector or Component inspector during authoring.
When you add the List component to an application, you can use the Accessibility panel to
make it accessible to screen readers. First, you must add the following line of code to
enable accessibility:
mx.accessibility.ListAccImpl.enableAccessibility();
You enable accessibility for a component only once, regardless of how many instances you have of
the component. For more information, see Chapter 17, "Creating Accessible Content," in Using
Flash.
450 Chapter 6: Components Dictionary
and
List.addItemAt()
Description
Jump to the next item that has
label.
Toggle key that allows multiple noncontiguous selections and
deselections.
Selection moves down one item.
Selection moves to the top of the list.
Selection moves down one page.
Selection moves up one page.
Allows for contiguous selection.
Selection moves up one item.
Components Dictionary
methods to add items to the list.
Key.getAscii()
"Creating custom focus navigation"
419.
CHAPTER 6
as the first character in its