List.addItem()

可用性

Flash Player 6.0.79。

版本

Flash MX 2004。

用法

listInstance.addItem(label[, data])
listInstance.addItem(itemObject)

参数

label 一个字符串，它指明新项目的标签。

data 项目的数据。此参数是可选的，可以是任何数据类型。

itemObject 项目对象，通常具有 label 属性和 data 属性。

返回

在其位置添加了项目的索引。

描述

方法；在列表的结尾添加新项目。

在第一个用法范例中，始终使用指定的 label 属性和 data 属性（如果已指定）来创建项目
对象。

第二个用法范例添加了指定的项目对象。

调用此方法会修改 List 组件的数据提供程序。如果与其他组件共享数据提供程序，那些组件也将会更新。

范例

下面两行代码都会将项目添加到 myList 实例。要试试这行代码，可将一个 List 拖到舞台，并为其设定实例名称 myList。将下面的代码添加到时间轴中的第一帧：

myList.addItem("this is an Item");
myList.addItem({label:"Gordon",age:"very old",data:123});