Language Version : | ActionScript 3.0 |
Runtime Versions : | Flash Player 9, AIR 1.1 |
The PropertyChangeEvent class represents the event object
passed to the event listener when one of the properties of
an object has changed, and provides information about the change.
This event is used by collection classes, and is the only way for
collections to know that the data they represent has changed.
This event is also used by the Flex data binding mechanism.
public var kind:String
Language Version : | ActionScript 3.0 |
Runtime Versions : | Flash Player 9, AIR 1.1 |
Specifies the kind of change.
The possible values are PropertyChangeEventKind.UPDATE
,
PropertyChangeEventKind.DELETE
, and null
.
public var newValue:Object
Language Version : | ActionScript 3.0 |
Runtime Versions : | Flash Player 9, AIR 1.1 |
The value of the property after the change.
public var oldValue:Object
Language Version : | ActionScript 3.0 |
Runtime Versions : | Flash Player 9, AIR 1.1 |
The value of the property before the change.
public var property:Object
Language Version : | ActionScript 3.0 |
Runtime Versions : | Flash Player 9, AIR 1.1 |
A String, QName, or int specifying the property that changed.
public var source:Object
Language Version : | ActionScript 3.0 |
Runtime Versions : | Flash Player 9, AIR 1.1 |
The object that the change occured on.
public function PropertyChangeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, kind:String = null, property:Object = null, oldValue:Object = null, newValue:Object = null, source:Object = null)
Language Version : | ActionScript 3.0 |
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 ) — Specifies the kind of change.
The possible values are PropertyChangeEventKind.UPDATE ,
PropertyChangeEventKind.DELETE , and null .
|
|
| property:Object (default = null ) — A String, QName, or int
specifying the property that changed.
|
|
| oldValue:Object (default = null ) — The value of the property before the change.
|
|
| newValue:Object (default = null ) — The value of the property after the change.
|
|
| source:Object (default = null ) — The object that the change occured on.
|
public static function createUpdateEvent(source:Object, property:Object, oldValue:Object, newValue:Object):PropertyChangeEvent
Language Version : | ActionScript 3.0 |
Runtime Versions : | Flash Player 9, AIR 1.1 |
Returns a new PropertyChangeEvent of kind
PropertyChangeEventKind.UPDATE
with the specified properties.
This is a convenience method.
Parameters
| source:Object — The object where the change occured.
|
|
| property:Object — A String, QName, or int
specifying the property that changed,
|
|
| oldValue:Object — The value of the property before the change.
|
|
| newValue:Object — The value of the property after the change.
|
Returnspublic static const PROPERTY_CHANGE:String = propertyChange
Language Version : | ActionScript 3.0 |
Runtime Versions : | Flash Player 9, AIR 1.1 |
The PropertyChangeEvent.PROPERTY_CHANGE
constant defines the value of the
type
property of the event object for a PropertyChange
event.
The properties of the event object have the following values:
Property | Value |
---|
bubbles | Determined by the constructor; defaults to false. |
cancelable | Determined by the constructor; defaults to false. |
kind | The kind of change; PropertyChangeEventKind.UPDATE
or PropertyChangeEventKind.DELETE. |
oldValue | The original property value. |
newValue | The new property value, if any. |
property | The property that changed. |
source | The object that contains the property that changed. |
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 . |
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. |
Mon Jul 9 2012, 07:18 PM -04:00