Package | mx.events |
Class | public class PropertyChangeEvent |
Inheritance | PropertyChangeEvent Event Object |
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
More examples
Learn more
Related API Elements
Property | Defined By | ||
---|---|---|---|
bubbles : Boolean [read-only]
Indicates whether an event is a bubbling event. | Event | ||
cancelable : Boolean [read-only]
Indicates whether the behavior associated with the event can be prevented. | Event | ||
constructor : Object
A reference to the class object or constructor function for a given object instance. | Object | ||
currentTarget : Object [read-only]
The object that is actively processing the Event object with an event listener. | Event | ||
eventPhase : uint [read-only]
The current phase in the event flow. | Event | ||
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 | ||
target : Object [read-only]
The event target. | Event | ||
type : String [read-only]
The type of event. | Event |
Method | Defined 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 | ||
Duplicates an instance of an Event subclass. | Event | ||
createUpdateEvent(source:Object, property:Object, oldValue:Object, newValue:Object):PropertyChangeEvent [static]
Returns a new PropertyChangeEvent of kind
PropertyChangeEventKind.UPDATE
with the specified properties. | PropertyChangeEvent | ||
A utility function for implementing the toString() method in custom
ActionScript 3.0 Event classes. | Event | ||
Indicates whether an object has a specified property defined. | Object | ||
Checks whether the preventDefault() method has been called on the event. | Event | ||
Indicates whether an instance of the Object class is in the prototype chain of the object specified
as the parameter. | Object | ||
Cancels an event's default behavior if that behavior can be canceled. | Event | ||
Indicates whether the specified property exists and is enumerable. | Object | ||
Sets the availability of a dynamic property for loop operations. | Object | ||
Prevents processing of any event listeners in the current node and any subsequent nodes in
the event flow. | Event | ||
Prevents processing of any event listeners in nodes subsequent to the current node in the
event flow. | Event | ||
Returns the string representation of this object, formatted according to locale-specific conventions. | Object | ||
Returns a string containing all the properties of the Event object. | Event | ||
Returns the primitive value of the specified object. | Object |
Constant | Defined 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 |
kind | property |
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
.
newValue | property |
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.
oldValue | property |
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.
property | property |
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.
source | property |
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.
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.
Parameterstype: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.
|
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.
|
PropertyChangeEvent — A newly constructed PropertyChangeEvent
with the specified properties.
|
PROPERTY_CHANGE | Constant |
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:
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. |
Thu Dec 6 2018, 01:12 PM -08:00