使用 List 组件

您可以建立一个列表，以便用户可以选择一项或多项。例如，用户访问一个电子商务网站需要选择想要购买的项目。一共有 30 个项目，用户在列表中上下滚动，并通过单击选择一项。

您也可以设计一个列表，该列表使用自定义影片剪辑作为行，这样就可以向用户显示更多信息。例如，在电子邮件应用程序中，每个信箱可能就是一个 List 组件，而每行可能会有指明优先级和状态的图标。

List 组件参数

以下是您可以在属性检查器中或在“组件检查器”面板中为每个 List 组件实例设置的创作参数：

data 填充列表数据的值数组。默认值为 []（空数组）。没有相应的运行时属性。

labels 填充列表的标签值的文本值数组。默认值为 []（空数组）。没有相应的运行时属性。

multipleSelection 一个布尔值，它指明是 (true) 否 (false) 可以选择多个值。默认值为 false。

rowHeight指明每行的高度，以像素为单位。默认值是 20。设置字体不会更改行的高度。

您可以使用 List 实例的方法、属性和事件为其编写动作脚本来设置其他选项。有关详细信息，请参阅 List 类。

创建具有 List 组件的应用程序

以下过程解释了如何在创作时将 List 组件添加到应用程序。在本例中，列表是一个有三个项目的范例。

将 List 组件从“组件”面板拖到舞台。
选择列表，然后选择“修改”>“变形”，调整大小以适应您的应用程序。
在属性检查器中，执行以下操作：
- 输入实例名称 myList。
- 为标签参数输入 Item1、Item2 和 Item3。
- 为数据参数输入 item1.html、item2.html、item3.html。
选择“控制”>“测试影片”，以查看带项目的列表。
您可以在应用程序中使用数据属性值来打开 HTML 文件。

以下过程解释了如何在创作时将 List 组件添加到应用程序。在本例中，列表是一个有三个项目的范例。

将 List 组件从“组件”面板拖到舞台。
选择列表，然后选择“修改”>“变形”，调整大小以适应您的应用程序。
在“动作”面板中，输入实例名称 myList
在时间轴中选择第一帧，在“动作”面板中，输入下列代码：
```
myList.dataProvider = myDP;
```
如果已经定义了名为 myDP 的数据提供程序，那么列表中将填入数据。有关数据提供程序的详细信息，请参阅 List.dataProvider。
选择“控制”>“测试影片”，以查看带项目的列表。