MACROMEDIA DIRECTOR MX 2004-USING DIRECTOR, Use Manual, Page: 216 / 500

216 Chapter 9: Using Flash, Flash Components, and Other Interactive Media Types
List component
The List component is a scrollable single- or multiple-selection list box. A list can also display
graphics, including other components.
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.
You can set up a list so that users can make either single or multiple selections. For example, a user
visiting an e-commerce website needs to select which item to buy. There are 30 items, and the
user scrolls through a list and selects one by clicking it.
You can also design a list that uses custom movie clips as rows so you can display more
information to the user. For example, in an e-mail application, each mailbox could be a List
component and each row could have icons to indicate priority and status.
List component parameters
The following are authoring parameters that you can set for each List component instance in the
Property inspector or in the Component Inspector panel:
data
An array of values that populate the data of the list. The default value is [] (an empty
array). There is no equivalent runtime property.
labels
An array of text values that populate the label values of list. The default value is [] (an
empty array). There is no equivalent runtime property.
multipleSelection
A Boolean value that indicates whether you can select multiple values (true)
or not (false). The default value is false.
rowHeight
indicates the height, in pixels, of each row. The default value is 20. Setting a font does
not change the height of a row.
You can write scripts to set additional options for List instances using its methods, properties, and
events. For more information, see “List class” in the Flash documentation.
Customizing the List component
You can transform a List component horizontally and vertically both while authoring and
at runtime.
When a list is resized, the rows of the list shrink horizontally, clipping any text within them.
Vertically, the list adds or removes rows as needed. Scroll bars position themselves automatically.
Using styles with the List component
You can set style properties to change the appearance of a List component.