关于 Collection 标记

Collection 标记用于描述在创作时可在"值"对话框中修改为项目集合的对象数组。这些对象的类型由 collectionItem 属性标识。Collection 属性包含一系列在单独类中定义的集合项目。单独类可以是 mx.utils.CollectionImpl 或其子类。使用由 collectionClass 属性标识的类的方法可以访问这些单个对象。

"组件"检查器中的集合属性和单击放大镜时显示的"值"对话框。


Collection 标记的语法如下:

[Collection (name="name", variable="varname", collectionClass="mx.utils.CollectionImpl", collectionItem="coll-item-classname", identifier="string")] 
public var varname:mx.utils.Collection;

下表对 Collection 标记的属性进行说明:

属性

类型

说明

name

String

(必需)显示在"组件"检查器中的集合名称。

variable

String

(必需)指向基础 Collection 对象的 ActionScript 变量(例如,可以将 Collection 参数命名为 Columns,但基础 variable 属性可以是 __columns)。

collectionClass

String

(必需)指定要将集合属性实例化的类的类型。它通常为 mx.utils.CollectionImpl,但也可以是扩展 mx.utils.CollectionImpl 的类。

collectionItem

String

(必需)指定要存储在集合中的一类集合项目。该类包含它自己的通过元数据公开的可检查属性。

identifier

String

(必需)指定在用户通过"值"对话框添加一个新集合项目时,Flash MX 用作默认标识符的可检查属性(在集合项目类中)的名称。每当用户创建一个新集合项目时,Flash MX 都会将该项目的名称设置为 identifier,外加一个唯一索引(例如,如果 identifier=name,则"值"对话框显示 name0、name1、name2,依此类推)。

有关详细信息,请参阅集合属性