GODPAPER | All Packages | All Classes | Index | Frames No Frames |
CollectionEvent

Package | mx.events
Class | public class CollectionEvent
Inheritance | CollectionEvent flash.events.Event

Language Version : | ActionScript 3.0

Product Version : | Flex 3

Runtime Versions : | Flash Player 9, AIR 1.1

The mx.events.CollectionEvent class represents an event that is dispatched when the associated collection changes.

See also

FlexEvent.CURSOR_UPDATE

Public Properties

| Property | Defined By
--- | --- | ---
|  | items : Array When the kind is CollectionEventKind.ADD or CollectionEventKind.REMOVE the items property is an Array of added/removed items. | CollectionEvent
|  | kind : String Indicates the kind of event that occurred. | CollectionEvent
|  | location : int When the kind value is CollectionEventKind.ADD, CollectionEventKind.MOVE, CollectionEventKind.REMOVE, or CollectionEventKind.REPLACE, this property is the zero-base index in the collection of the item(s) specified in the items property. | CollectionEvent
|  | oldLocation : int When the kind value is CollectionEventKind.MOVE, this property is the zero-based index in the target collection of the previous location of the item(s) specified by the items property. | CollectionEvent

Public Methods

| Method | Defined By
--- | --- | ---
|  | CollectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, kind:String = null, location:int = -1, oldLocation:int = -1, items:Array = null) Constructor. | CollectionEvent

Public Constants

| Constant | Defined By
--- | --- | ---
|  | COLLECTION_CHANGE : String = collectionChange [static] The CollectionEvent.COLLECTION_CHANGE constant defines the value of the type property of the event object for an event that is dispatched when a collection has changed. | CollectionEvent

Property Detail

items | property

`public var items:Array`

Language Version : | ActionScript 3.0

Product Version : | Flex 3

Runtime Versions : | Flash Player 9, AIR 1.1

When the `kind` is `CollectionEventKind.ADD` or `CollectionEventKind.REMOVE` the `items` property is an Array of added/removed items. When the `kind` is `CollectionEventKind.REPLACE` or `CollectionEventKind.UPDATE` the `items` property is an Array of PropertyChangeEvent objects with information about the items affected by the event. When a value changes, query the `newValue` and `oldValue` fields of the PropertyChangeEvent objects to find out what the old and new values were. When the `kind` is `CollectionEventKind.REFRESH` or `CollectionEventKind.RESET`, this array has zero length.

The default value is `[ ]`.

See also

PropertyChangeEvent

kind | property |

`public var kind:String`

Language Version : | ActionScript 3.0

Product Version : | Flex 3

Runtime Versions : | Flash Player 9, AIR 1.1

Indicates the kind of event that occurred. The property value can be one of the values in the CollectionEventKind class, or `null`, which indicates that the kind is unknown.

The default value is `null`.

See also

CollectionEventKind

location | property |

`public var location:int`

Language Version : | ActionScript 3.0

Product Version : | Flex 3

Runtime Versions : | Flash Player 9, AIR 1.1

When the `kind` value is `CollectionEventKind.ADD`, `CollectionEventKind.MOVE`, `CollectionEventKind.REMOVE`, or `CollectionEventKind.REPLACE`, this property is the zero-base index in the collection of the item(s) specified in the `items` property.

The default value is `-1`.

See also

CollectionEventKind

oldLocation | property |

`public var oldLocation:int`

Language Version : | ActionScript 3.0

Product Version : | Flex 3

Runtime Versions : | Flash Player 9, AIR 1.1

When the `kind` value is `CollectionEventKind.MOVE`, this property is the zero-based index in the target collection of the previous location of the item(s) specified by the `items` property.

The default value is `-1`.

Constructor Detail

CollectionEvent | () | Constructor

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

Language Version : | ActionScript 3.0

Product Version : | Flex 3

Runtime Versions : | Flash Player 9, AIR 1.1

Constructor.

Parameters

| `type:String` — The event type; indicates the action that triggered the event.
| `bubbles:Boolean` (default = `false`)`` — Specifies whether the event can bubble up the display list hierarchy.
| `cancelable:Boolean` (default = `false`)`` — Specifies whether the behavior associated with the event can be prevented.
| `kind:String` (default = `null`)`` — Indicates the kind of event that occured. The parameter value can be one of the values in the CollectionEventKind class, or `null`, which indicates that the kind is unknown.
| `location:int` (default = `-1`)`` — When the `kind` is `CollectionEventKind.ADD`, `CollectionEventKind.MOVE`, `CollectionEventKind.REMOVE`, or `CollectionEventKind.REPLACE`, this value indicates at what location the item(s) specified in the `items property` can be found within the target collection.
| `oldLocation:int` (default = `-1`)`` — When the `kind` is `CollectionEventKind.MOVE`, this value indicates the old location within the target collection of the item(s) specified in the `items` property.
| `items:Array` (default = `null`)`` — Array of objects with information about the items affected by the event, as described in the `items` property. When the `kind` is `CollectionEventKind.REFRESH` or `CollectionEventKind.RESET`, this Array has zero length.

Constant Detail

COLLECTION_CHANGE | Constant

`public static const COLLECTION_CHANGE:String = collectionChange`

Language Version : | ActionScript 3.0

Product Version : | Flex 3

Runtime Versions : | Flash Player 9, AIR 1.1

The CollectionEvent.COLLECTION_CHANGE constant defines the value of the `type` property of the event object for an event that is dispatched when a collection has changed.

The properties of the event object have the following values. Not all properties are meaningful for all kinds of events. See the detailed property descriptions for more information.

Property | Value
--- | ---
`bubbles` | false
`cancelable` | false
`currentTarget` | The Object that defines the event listener that handles the event. For example, if you use `myButton.addEventListener()` to register an event listener, myButton is the value of the `currentTarget`.
`items` | An Array of objects with information about the items affected by the event. The contents of this field depend on the event kind; for details see the `items` property
`kind` | The kind of event. The valid values are defined in the CollectionEventKind class as constants.
`location` | Location within the target collection of the item(s) specified in the `items` property.
`oldLocation` | the previous location in the collection of the item specified in the `items` property.
`target` | The Object that dispatched the event; it is not always the Object listening for the event. Use the `currentTarget` property to always access the Object listening for the event.
`type` | CollectionEvent.COLLECTION_CHANGE

Thu Jan 16 2014, 01:11 PM +08:00