mx.events.CollectionEvent (ActionScript 3.0)

	属性	定义方
		bubbles : Boolean [] 指示事件是否为冒泡事件。	Event
		cancelable : Boolean [] 指示是否可以阻止与事件相关联的行为。	Event
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		currentTarget : Object [] 当前正在使用某个事件侦听器处理 Event 对象的对象。	Event
		eventPhase : uint [] 事件流中的当前阶段。	Event
		items : Array 如果 kind 为 CollectionEventKind.ADD 或 CollectionEventKind.REMOVE，则 items 属性为已添加/已删除项目的 Array。	CollectionEvent
		kind : String 指示发生的事件类型。	CollectionEvent
		location : int 如果 kind 值为 CollectionEventKind.ADD、CollectionEventKind.MOVE、CollectionEventKind.REMOVE 或 CollectionEventKind.REPLACE，则此属性为 items 属性中指定的项目集合中基于零的索引。	CollectionEvent
		oldLocation : int 如果 kind 的值为 CollectionEventKind.MOVE，则此属性为 items 属性中指定的项目在目标集合中原来位置的从零开始的索引。	CollectionEvent
		prototype : Object [] 对类或函数对象的原型对象的引用。	Object
		target : Object [] 事件目标。	Event
		type : String [] 事件的类型。	Event

	方法	定义方
		CollectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, kind:String = null, location:int = -1, oldLocation:int = -1, items:Array = null) 构造函数。	CollectionEvent
		clone():Event 复制 Event 子类的实例。	Event
		formatToString(className:String, ... arguments):String 用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。	Event
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		isDefaultPrevented():Boolean 检查是否已对事件调用 preventDefault() 方法。	Event
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		preventDefault():void 如果可以取消事件的默认行为，则取消该行为。	Event
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		stopImmediatePropagation():void 防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。	Event
		stopPropagation():void 防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。	Event
		toString():String 返回一个字符串，其中包含 Event 对象的所有属性。	Event
		valueOf():Object 返回指定对象的原始值。	Object

公共常量

	常量		定义方
		ACTIVATE : String = "activate" [] Event.ACTIVATE 常量定义 activate 事件对象的 type 属性值。	Event
		ADDED : String = "added" [] Event.ADDED 常量定义 added 事件对象的 type 属性值。	Event
		ADDED_TO_STAGE : String = "addedToStage" [] Event.ADDED_TO_STAGE 常量定义 addedToStage 事件对象的 type 属性值。	Event
		CANCEL : String = "cancel" [] Event.CANCEL 常量定义 cancel 事件对象的 type 属性的值。	Event
		CHANGE : String = "change" [] Event.CHANGE 常量定义 change 事件对象的 type 属性值。	Event
		CLOSE : String = "close" [] Event.CLOSE 常量定义 close 事件对象的 type 属性的值。	Event
		CLOSING : String = "closing" [] Event.CLOSING 常量定义 closing 事件对象的 type 属性值。	Event
		COLLECTION_CHANGE : String = "collectionChange" [] CollectionEvent.COLLECTION_CHANGE 常数可为在集合发生更改时调度的事件定义事件对象的 type 属性值。	CollectionEvent
		COMPLETE : String = "complete" [] Event.COMPLETE 常量定义 complete 事件对象的 type 属性值。	Event
		CONNECT : String = "connect" [] Event.CONNECT 常量定义 connect 事件对象的 type 属性值。	Event
		DEACTIVATE : String = "deactivate" [] Event.DEACTIVATE 常量定义 deactivate 事件对象的 type 属性值。	Event
		DISPLAYING : String = "displaying" [] 定义 displaying 事件对象的 type 属性值。	Event
		ENTER_FRAME : String = "enterFrame" [] Event.ENTER_FRAME 常量定义 enterFrame 事件对象的 type 属性值。	Event
		EXITING : String = "exiting" [] Event.EXITING 常量定义 exiting 事件对象的 type 属性值。	Event
		FULLSCREEN : String = "fullScreen" [] Event.FULL_SCREEN 常量定义 fullScreen 事件对象的 type 属性值。	Event
		HTML_BOUNDS_CHANGE : String = "htmlBoundsChange" [] Event.HTML_BOUNDS_CHANGE 常量定义 htmlBoundsChange 事件对象的 type 属性值。	Event
		HTML_DOM_INITIALIZE : String = "htmlDOMInitialize" [] Event.HTML_DOM_INITIALIZE 常量定义 htmlDOMInitialize 事件对象的 type 属性值。	Event
		HTML_RENDER : String = "htmlRender" [] Event.HTML_RENDER 常量定义 htmlRender 事件对象的 type 属性值。	Event
		ID3 : String = "id3" [] Event.ID3 常量定义 id3 事件对象的 type 属性值。	Event
		INIT : String = "init" [] Event.INIT 常量定义 init 事件对象的 type 属性值。	Event
		LOCATION_CHANGE : String = "locationChange" [] Event.LOCATION_CHANGE 常量定义 locationChange 事件对象的 type 属性值。	Event
		MOUSE_LEAVE : String = "mouseLeave" [] Event.MOUSE_LEAVE 常量定义 mouseLeave 事件对象的 type 属性值。	Event
		NETWORK_CHANGE : String = "networkChange" [] Event.NETWORK_CHANGE 常量定义 networkChange 事件对象的 type 属性值。	Event
		OPEN : String = "open" [] Event.OPEN 常量用于定义 open 事件对象的 type 属性值。	Event
		REMOVED : String = "removed" [] Event.REMOVED 常量定义 removed 事件对象的 type 属性值。	Event
		REMOVED_FROM_STAGE : String = "removedFromStage" [] Event.REMOVED_FROM_STAGE 常量定义 removedFromStage 事件对象的 type 属性值。	Event
		RENDER : String = "render" [] Event.RENDER 常量定义 render 事件对象的 type 属性的值。	Event
		RESIZE : String = "resize" [] Event.RESIZE 常量定义 resize 事件对象的 type 属性的值。	Event
		SCROLL : String = "scroll" [] Event.SCROLL 常量定义 scroll 事件对象的 type 属性值。	Event
		SELECT : String = "select" [] Event.SELECT 常量定义 select 事件对象的 type 属性的值。	Event
		SOUND_COMPLETE : String = "soundComplete" [] Event.SOUND_COMPLETE 常量定义 soundComplete 事件对象的 type 属性值。	Event
		TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [] Event.TAB_CHILDREN_CHANGE 常量定义 tabChildrenChange 事件对象的 type 属性值。	Event
		TAB_ENABLED_CHANGE : String = "tabEnabledChange" [] Event.TAB_ENABLED_CHANGE 常量定义 tabEnabledChange 事件对象的 type 属性值。	Event
		TAB_INDEX_CHANGE : String = "tabIndexChange" [] Event.TAB_INDEX_CHANGE 常量定义 tabIndexChange 事件对象的 type 属性值。	Event
		UNLOAD : String = "unload" [] Event.UNLOAD 常量定义 unload 事件对象的 type 属性值。	Event
		USER_IDLE : String = "userIdle" [] Event.USER_IDLE 常量定义 userIdle 事件对象的 type 属性值。	Event
		USER_PRESENT : String = "userPresent" [] Event.USER_PRESENT 常量定义 userPresent 事件对象的 type 属性值。	Event

属性详细信息

items

属性

public var items:Array

如果 kind 为 CollectionEventKind.ADD 或 CollectionEventKind.REMOVE，则 items 属性为已添加/已删除项目的 Array。如果 kind 为 CollectionEventKind.REPLACE 或 CollectionEventKind.UPDATE，则 items 属性为 PropertyChangeEvent 对象 Array，其中包含受事件影响的项目的相关信息。如果值发生更改，请查询 PropertyChangeEvent 对象的 newValue 和 oldValue 字段以了解原来的值和新值。如果 kind 为 CollectionEventKind.REFRESH 或 CollectionEventKind.RESET，则此数组的长度为零。

默认值为 [ ].

另请参见

PropertyChangeEvent

kind

属性

public var kind:String

指示发生的事件类型。此属性值可以是 CollectionEventKind 类中的一个值，也可以是 null，用于指示类型未知。

默认值为 null.

另请参见

CollectionEventKind

location

属性

public var location:int

如果 kind 值为 CollectionEventKind.ADD、CollectionEventKind.MOVE、CollectionEventKind.REMOVE 或 CollectionEventKind.REPLACE，则此属性为 items 属性中指定的项目集合中基于零的索引。

默认值为 -1.

另请参见

CollectionEventKind

oldLocation

属性

public var oldLocation:int

如果 kind 的值为 CollectionEventKind.MOVE，则此属性为 items 属性中指定的项目在目标集合中原来位置的从零开始的索引。

默认值为 -1.

构造函数详细信息

CollectionEvent

()

构造函数

public function CollectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, kind:String = null, location:int = -1, oldLocation:int = -1, items:Array = null)

构造函数。

参数

	`type:String` — 事件类型；指示触发事件的动作。

	`bubbles:Boolean` (default = `false`) — 指定该事件是否可以在显示列表层次结构得到冒泡处理。

	`cancelable:Boolean` (default = `false`) — 指定是否可以防止与事件相关联的行为。

	`kind:String` (default = `null`) — 指示发生的事件类型。此参数值可以是 CollectionEventKind 类中的一个值，也可以是 `null`，用于指示类型未知。

	`location:int` (default = `-1`) — `kind` 为 `CollectionEventKind.ADD`、`CollectionEventKind.MOVE`、`CollectionEventKind.REMOVE` 或 `CollectionEventKind.REPLACE` 时，此值指示可以在目标集合中找到 `items` 属性中指定的项目的位置。

	`oldLocation:int` (default = `-1`) — `kind` 为 `CollectionEventKind.MOVE` 时，此值指示 `items` 属性中指定的项目在目标集合中的原位置。

	`items:Array` (default = `null`) — 对象数组，其中包含有关受事件影响的项目的信息，如 `items` 属性所述。如果 `kind` 为 `CollectionEventKind.REFRESH` 或 `CollectionEventKind.RESET`，则此 Array 的长度为零。

常量详细信息

COLLECTION_CHANGE

常量

public static const COLLECTION_CHANGE:String = "collectionChange"

CollectionEvent.COLLECTION_CHANGE 常数可为在集合发生更改时调度的事件定义事件对象的 type 属性值。

事件对象的属性具有下列值。并非所有属性对于各种事件都有意义。有关详细信息，请参阅详细的属性说明。

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`items`	对象 Array，其中包含有关受事件影响的项目的信息。此字段的内容取决于事件的类型；有关详细信息，请参阅 `items` 属性
`kind`	事件的类型。有效值定义为 CollectionEventKind 类中的常数。
`location`	`items` 属性中指定的项目在目标集合中的位置。
`oldLocation`	`items` 属性中指定的项目原来在目标集合中的位置。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`type`	CollectionEvent.COLLECTION_CHANGE

包	mx.events
Class	public class CollectionEvent
继承	CollectionEvent Event Object