使用 List 组件

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

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

List 组件参数

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

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

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

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

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

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

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

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

要将一个简单的 List 组件添加到一个应用程序中,请执行以下操作:

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

    您可以在应用程序中使用数据属性值来打开 HTML 文件。

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

要将 List 组件添加到应用程序,请执行以下操作:

  1. 将 List 组件从“组件”面板拖到舞台。
  2. 选择列表,然后选择“修改”>“变形”,调整大小以适应您的应用程序。
  3. 在“动作”面板中,输入实例名称 myList
  4. 在时间轴中选择第一帧,在“动作”面板中,输入下列代码:
    myList.dataProvider = myDP;
    

    如果已经定义了名为 myDP 的数据提供程序,那么列表中将填入数据。有关数据提供程序的详细信息,请参阅 List.dataProvider

  5. 选择“控制”>“测试影片”,以查看带项目的列表。