Packagemx.events
Classpublic class PropertyChangeEvent
InheritancePropertyChangeEvent Inheritance flash.events.Event

Language Version : ActionScript 3.0
Product Version : Flex 3
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.

See also

PropertyChangeEventKind


Public Properties
 PropertyDefined By
  kind : String
Specifies the kind of change.
PropertyChangeEvent
  newValue : Object
The value of the property after the change.
PropertyChangeEvent
  oldValue : Object
The value of the property before the change.
PropertyChangeEvent
  property : Object
A String, QName, or int specifying the property that changed.
PropertyChangeEvent
  source : Object
The object that the change occured on.
PropertyChangeEvent
Public Methods
 MethodDefined By
  
PropertyChangeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, kind:String = null, property:Object = null, oldValue:Object = null, newValue:Object = null, source:Object = null)
Constructor.
PropertyChangeEvent
  
createUpdateEvent(source:Object, property:Object, oldValue:Object, newValue:Object):PropertyChangeEvent
[static] Returns a new PropertyChangeEvent of kind PropertyChangeEventKind.UPDATE with the specified properties.
PropertyChangeEvent
Public Constants
 ConstantDefined By
  PROPERTY_CHANGE : String = propertyChange
[static] The PropertyChangeEvent.PROPERTY_CHANGE constant defines the value of the type property of the event object for a PropertyChange event.
PropertyChangeEvent
Property Detail
kindproperty
public var kind:String

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Specifies the kind of change. The possible values are PropertyChangeEventKind.UPDATE, PropertyChangeEventKind.DELETE, and null.

newValueproperty 
public var newValue:Object

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

The value of the property after the change.

oldValueproperty 
public var oldValue:Object

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

The value of the property before the change.

propertyproperty 
public var property:Object

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

A String, QName, or int specifying the property that changed.

sourceproperty 
public var source:Object

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

The object that the change occured on.

Constructor Detail
PropertyChangeEvent()Constructor
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
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) — 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.
Method Detail
createUpdateEvent()method
public static function createUpdateEvent(source:Object, property:Object, oldValue:Object, newValue:Object):PropertyChangeEvent

Language Version : ActionScript 3.0
Product Version : Flex 3
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.

Returns
PropertyChangeEvent — A newly constructed PropertyChangeEvent with the specified properties.
Constant Detail
PROPERTY_CHANGEConstant
public static const PROPERTY_CHANGE:String = propertyChange

Language Version : ActionScript 3.0
Product Version : Flex 3
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:

PropertyValue
bubblesDetermined by the constructor; defaults to false.
cancelableDetermined by the constructor; defaults to false.
kindThe kind of change; PropertyChangeEventKind.UPDATE or PropertyChangeEventKind.DELETE.
oldValueThe original property value.
newValueThe new property value, if any.
propertyThe property that changed.
sourceThe object that contains the property that changed.
currentTargetThe 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.
targetThe 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.