適用於 Adobe® Flash® Platform 的 ActionScript® 3.0 參考
首頁  |  隱藏套件和類別清單 |  套件  |  類別  |  新增內容  |  索引  |  附錄  |  為什麼顯示英文?
篩選: 從伺服器擷取資料...
從伺服器擷取資料...
mx.events 

PropertyChangeEvent  - AS3 Flex

套件mx.events
類別public class PropertyChangeEvent
繼承PropertyChangeEvent Inheritance Event Inheritance Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: 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.

相關 API 元素



公用屬性
 屬性定義自
 Inheritedbubbles : Boolean
[唯讀] 指出事件是否為反昇事件。
Event
 Inheritedcancelable : Boolean
[唯讀] 指出是否可避免與事件相關聯的行為指令。
Event
 Inheritedconstructor : Object
類別物件的參照或是特定物件實體的建構函數。
Object
 InheritedcurrentTarget : Object
[唯讀] 正主動使用事件偵聽程式處理 Event 物件的物件。
Event
 InheritedeventPhase : uint
[唯讀] 事件流程中的目前階段。
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
 Inheritedtarget : Object
[唯讀] 事件目標。
Event
 Inheritedtype : String
[唯讀] 事件類型。
Event
公用方法
 方法定義自
  
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
 Inherited
複製 Event 子類別的實體。
Event
  
createUpdateEvent(source:Object, property:Object, oldValue:Object, newValue:Object):PropertyChangeEvent
[靜態] Returns a new PropertyChangeEvent of kind PropertyChangeEventKind.UPDATE with the specified properties.
PropertyChangeEvent
 Inherited
formatToString(className:String, ... arguments):String
公用程式函數,可用來實作自訂 ActionScript 3.0 Event 類別中的 toString() 方法。
Event
 Inherited
指出物件是否有已定義的指定屬性。
Object
 Inherited
檢查是否已經對事件呼叫 preventDefault() 方法。
Event
 Inherited
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。
Object
 Inherited
如果可以取消事件的預設行為指令,則取消該行為指令。
Event
 Inherited
指出指定的屬性是否存在,以及是否可列舉。
Object
 Inherited
為迴圈作業設定動態屬性的可用性。
Object
 Inherited
避免處理事件流程中,目前節點以及任何後續節點中的任何事件偵聽程式。
Event
 Inherited
避免處理接續在事件流程中的目前節點之後,後續節點中的任何事件偵聽程式。
Event
 Inherited
傳回代表此物件的字串,根據地區特定慣例進行格式化。
Object
 Inherited
傳回包含 Event 物件所有屬性的字串。
Event
 Inherited
會傳回指定之物件的基本值。
Object
公用常數
 常數定義自
  PROPERTY_CHANGE : String = "propertyChange"
[靜態] The PropertyChangeEvent.PROPERTY_CHANGE constant defines the value of the type property of the event object for a PropertyChange event.
PropertyChangeEvent
屬性詳細資訊

kind

屬性
public var kind:String

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

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

newValue

屬性 
public var newValue:Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The value of the property after the change.

oldValue

屬性 
public var oldValue:Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The value of the property before the change.

property

屬性 
public var property:Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

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

source

屬性 
public var source:Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The object that the change occured on.

建構函式詳細資料

PropertyChangeEvent

()建構函式
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)

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Constructor.

參數
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.
方法詳細資訊

createUpdateEvent

()方法
public static function createUpdateEvent(source:Object, property:Object, oldValue:Object, newValue:Object):PropertyChangeEvent

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Returns a new PropertyChangeEvent of kind PropertyChangeEventKind.UPDATE with the specified properties. This is a convenience method.

參數

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

常數
public static const PROPERTY_CHANGE:String = "propertyChange"

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: 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.





[ X ]為什麼顯示英文?
「ActionScript 3.0 參考」的內容是以英文顯示

並非所有「ActionScript 3.0 參考」的內容都翻譯為所有語言。當語言元素未翻譯時,就會以英文顯示。例如,ga.controls.HelpBox 類別並沒有翻譯為任何語言。因此在參考的繁體中文版本中,ga.controls.HelpBox 類別就會以英文顯示。