(Preview)
| 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 |
Related API Elements
Public Properties
Hide Inherited Public Properties
Show Inherited Public Properties| 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 | |
Public Methods
| 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 | |
Public Constants
| 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 | ||
Property Detail
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.
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.
Parameterstype:String — The event type; indicates the action that triggered the event.
| |
bubbles:Boolean (default = false) | |
cancelable:Boolean (default = false) | |
kind:String (default = null)PropertyChangeEventKind.UPDATE,
PropertyChangeEventKind.DELETE, and null.
| |
property:Object (default = null) | |
oldValue:Object (default = null) | |
newValue:Object (default = null) | |
source:Object (default = null) |
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.
|
PropertyChangeEvent — A newly constructed PropertyChangeEvent
with the specified properties.
|
Constant Detail
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. |
Wed Nov 21 2018, 06:34 AM -08:00