Event  - AS3

指出事件是否為反昇事件。如果事件可以反昇，則此值為 true；否則為 false。

發生事件時，事件會經過三個事件流程階段： 捕捉階段會從顯示清單階層的頂端移到目標節點之前的節點；目標階段包含目標節點；而反昇階段則會從目標節點的後續節點返回顯示清單階層。

某些事件 (例如 activate 和 unload 事件)，都沒有反昇階段。 對於沒有反昇階段的事件，其 bubbles 屬性值為 false。

指出是否可避免與事件相關聯的行為指令。如果行為指令可以取消，則此值為 true；否則為 false。

相關 API 元素

正主動使用事件偵聽程式處理 Event 物件的物件。例如，如果使用者按下「確定」按鈕，目標節點可能是包含該按鈕的節點，或是包含其中一個已為該事件註冊事件偵聽程式之祖系的節點。

事件流程中的目前階段。 此屬性包含下列數值：

• 捕捉階段 (EventPhase.CAPTURING_PHASE)。
• 目標階段 (EventPhase.AT_TARGET)。
• 反昇階段 (EventPhase.BUBBLING_PHASE)。

事件目標。 此屬性包含目標節點。 例如，如果使用者按下「確定」按鈕，目標節點即為包含該按鈕的顯示清單節點。

事件類型。此類型必須區分大小寫。

建立 Event 物件，以當作參數傳遞至事件偵聽程式。

複製 Event 子類別的實體。

傳回新的 Event 物件，此物件是原始 Event 物件實體的副本。 您通常不會呼叫 clone()，因為 EventDispatcher 類別會在您重新傳送事件時自動呼叫它 (也就是說，當您從正在處理 event 的處理常式呼叫dispatchEvent(event) 的時候)。

新的 Event 物件包含原始物件的所有屬性。

在建立自己的自訂 Event 類別時，您必須覆寫繼承的 Event.clone() 方法，才能讓其複製自訂類別的屬性。 如果您沒有對加入事件子類別的所有屬性進行設定，這些屬性將無法在偵聽程式處理重新傳送的事件時，提供正確的值。

在這個範例中，PingEvent 是 Event 的子類別，因此會實作專屬的 clone() 版本。

     class PingEvent extends Event {
         var URL:String;
         
     public override function clone():Event {
              return new PingEvent(type, bubbles, cancelable, URL);
        }
     }
     

公用程式函數，可用來實作自訂 ActionScript 3.0 Event 類別中的 toString() 方法。建議覆寫 toString() 方法，但不一定要如此。

	 class PingEvent extends Event {
	  var URL:String;
	 
	 public override function toString():String { 
	  return formatToString("PingEvent", "type", "bubbles", "cancelable", "eventPhase", "URL"); 
	    }
	 }
	 

參數

檢查是否已經對事件呼叫 preventDefault() 方法。如果已呼叫 preventDefault()，則會傳回 true；否則會傳回 false。

相關 API 元素

如果可以取消事件的預設行為指令，則取消該行為指令。

許多事件都有預設會執行的相關行為指令。例如，如果使用者在文字欄位中輸入字元，預設的行為指令會將字元顯示在文字欄位中。 由於 TextEvent.TEXT_INPUT 事件的預設行為指令可以取消，因此，您可以使用 preventDefault() 方法來避免顯示字元。

不可取消的行為指令範例為與 Event.REMOVED 事件相關聯的預設行為指令，也就是當 Flash Player 要移除顯示清單中的顯示物件時，所產生的事件。 預設的行為指令 (移除元素) 無法取消，因此 preventDefault() 方法對此預設行為指令不會產生任何影響。

您可以使用 Event.cancelable 屬性來檢視是否可以避免與特定事件相關聯的預設行為指令。 如果 Event.cancelable 的值為 true，則可以使用 preventDefault() 來取消事件；否則，preventDefault() 不會產生任何影響。

相關 API 元素

避免處理事件流程中，目前節點以及任何後續節點中的任何事件偵聽程式。 這個方法會立即生效，並且會影響目前節點中的事件偵聽程式。 相較之下，stopPropagation() 方法會等到目前節點中的所有事件偵聽程式都處理完畢，才會生效。

注意：這個方法不會取消與此事件相關聯的行為指令；如需該功能，請參閱 preventDefault()。

相關 API 元素

避免處理接續在事件流程中的目前節點之後，後續節點中的任何事件偵聽程式。 這個方法不會對目前節點 (currentTarget) 中的任何事件偵聽程式造成影響。 相較之下，stopImmediatePropagation() 方法反而會造成無法處理目前節點和後續節點中的事件偵聽程式。 其它對此方法的呼叫則不會產生任何影響。 您可以在事件流程的任何階段呼叫這個方法。

注意：這個方法不會取消與此事件相關聯的行為指令；如需該功能，請參閱 preventDefault()。

相關 API 元素

傳回包含 Event 物件所有屬性的字串。 此字串的格式如下：

[Event type=value bubbles=value cancelable=value]

ACTIVATE 常數會定義 activate 事件物件的 type 屬性值。

注意：這個事件沒有「捕捉階段」也沒有「反昇階段」，這表示事件偵聽程式必須直接加入至任何可能的目標，不論目標是否在顯示清單上。

AIR for TV 裝置永遠不會自動傳送此事件。但是，您可以手動傳送。

這個事件具有下列屬性：

相關 API 元素

Event.ADDED 常數會定義 added 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.ADDED_TO_STAGE 常數會定義 addedToStage 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.BROWSER_ZOOM_CHANGE 常數會定義 browserZoomChange 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.CANCEL 常數會定義 cancel 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.CHANGE 常數會定義 change 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.CHANNEL_MESSAGE 常數會定義 channelMessage 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.CHANNEL_STATE 常數會定義 channelState 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.CLEAR 常數會定義 clear 事件物件的 type 屬性值。

這個事件具有下列屬性：

注意：TextField 物件不會傳送 clear、copy、cut、paste 或 selectAll 事件。TextField 物件一定會在快顯選單中加入「剪下」、「複製」、「貼上」、「清除」與「全選」命令。您無法將這些命令從 TextField 物件的快顯選單中移除。對於 TextField 物件，選擇這些命令 (或它們的鍵盤相對按鍵) 並不會產生 clear、copy、cut、paste 或 selectAll 事件。不過，其他延伸 InteractiveObject 類別的類別 (包括使用 Flash 文字引擎 (FTE) 建立的組件)，將會傳送這些事件以回應鍵盤快速鍵與快顯選單等使用者動作。

相關 API 元素

Event.CLOSE 常數會定義 close 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.CLOSING 常數會定義 closing 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.COMPLETE 常數會定義 complete 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.CONNECT 常數會定義 connect 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.CONTEXT3D_CREATE 常數定義了 context3Dcreate 事件物件的 type 屬性值。此事件只會由 Stage3D 物件引發，以回應對 Stage3D.requestContext3D 的呼叫或回應繫結至 Stage3D 物件之 Context3D 的 OS 觸發重設。請檢測 Stage3D.context3D 屬性以取得剛建立的 Context3D 物件。

相關 API 元素

定義 copy 事件物件的 type 屬性值。

這個事件具有下列屬性：

注意：TextField 物件不會傳送 clear、copy、cut、paste 或 selectAll 事件。TextField 物件一定會在快顯選單中加入「剪下」、「複製」、「貼上」、「清除」與「全選」命令。您無法將這些命令從 TextField 物件的快顯選單中移除。對於 TextField 物件，選擇這些命令 (或它們的鍵盤相對按鍵) 並不會產生 clear、copy、cut、paste 或 selectAll 事件。不過，其他延伸 InteractiveObject 類別的類別 (包括使用 Flash 文字引擎 (FTE) 建立的組件)，將會傳送這些事件以回應鍵盤快速鍵與快顯選單等使用者動作。

相關 API 元素

定義 cut 事件物件的 type 屬性值。

這個事件具有下列屬性：

注意：TextField 物件不會傳送 clear、copy、cut、paste 或 selectAll 事件。TextField 物件一定會在快顯選單中加入「剪下」、「複製」、「貼上」、「清除」與「全選」命令。您無法將這些命令從 TextField 物件的快顯選單中移除。對於 TextField 物件，選擇這些命令 (或它們的鍵盤相對按鍵) 並不會產生 clear、copy、cut、paste 或 selectAll 事件。不過，其他延伸 InteractiveObject 類別的類別 (包括使用 Flash 文字引擎 (FTE) 建立的組件)，將會傳送這些事件以回應鍵盤快速鍵與快顯選單等使用者動作。

相關 API 元素

Event.DEACTIVATE 常數會定義 deactivate 事件物件的 type 屬性值。

注意：這個事件沒有「捕捉階段」也沒有「反昇階段」，這表示事件偵聽程式必須直接加入至任何可能的目標，不論目標是否在顯示清單上。

AIR for TV 裝置永遠不會自動傳送此事件。但是，您可以手動傳送。

這個事件具有下列屬性：

相關 API 元素

Event.DISPLAYING 常數會定義 displaying 事件物件的 type 屬性值。

注意：這個事件不會經歷「捕捉階段」，而且不管目標是否在顯示清單上，都會直接傳送至目標。

這個事件具有下列屬性：

相關 API 元素

Event.ENTER_FRAME 常數會定義 enterFrame 事件物件的 type 屬性值。

注意：這個事件沒有「捕捉階段」也沒有「反昇階段」，這表示事件偵聽程式必須直接加入至任何可能的目標，不論目標是否在顯示清單上。

這個事件具有下列屬性：

相關 API 元素

Event.EXIT_FRAME 常數會定義 exitFrame 事件物件的 type 屬性值。

注意：這個事件沒有「捕捉階段」也沒有「反昇階段」，這表示事件偵聽程式必須直接加入至任何可能的目標，不論目標是否在顯示清單上。

這個事件具有下列屬性：

相關 API 元素

Event.EXITING 常數會定義 exiting 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.FRAME_CONSTRUCTED 常數會定義 frameConstructed 事件物件的 type 屬性值。

注意：這個事件沒有「捕捉階段」也沒有「反昇階段」，這表示事件偵聽程式必須直接加入至任何可能的目標，不論目標是否在顯示清單上。

這個事件具有下列屬性：

相關 API 元素

Event.FRAME_LABEL 常數會定義 frameLabel 事件物件的 type 屬性值。

注意：這個事件既沒有「捕捉階段」，也沒有「反昇階段」，這表示事件偵聽程式必須直接加入 FrameLabel 物件。

這個事件具有下列屬性：

相關 API 元素

Event.FULL_SCREEN 常數會定義 fullScreen 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.HTML_BOUNDS_CHANGE 常數會定義 htmlBoundsChange 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.HTML_DOM_INITIALIZE 常數會定義 htmlDOMInitialize 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.HTML_RENDER 常數會定義 htmlRender 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.ID3 常數會定義 id3 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.INIT 常數會定義 init 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.LOCATION_CHANGE 常數會定義 locationChange 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.MOUSE_LEAVE 常數會定義 mouseLeave 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.NETWORK_CHANGE 常數會定義 networkChange 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.OPEN 常數會定義 open 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.PASTE 常數會定義 paste 事件物件的 type 屬性值。

這個事件具有下列屬性：

注意：TextField 物件不會傳送 clear、copy、cut、paste 或 selectAll 事件。TextField 物件一定會在快顯選單中加入「剪下」、「複製」、「貼上」、「清除」與「全選」命令。您無法將這些命令從 TextField 物件的快顯選單中移除。對於 TextField 物件，選擇這些命令 (或它們的鍵盤相對按鍵) 並不會產生 clear、copy、cut、paste 或 selectAll 事件。不過，其他延伸 InteractiveObject 類別的類別 (包括使用 Flash 文字引擎 (FTE) 建立的組件)，將會傳送這些事件以回應鍵盤快速鍵與快顯選單等使用者動作。

相關 API 元素

Event.PREPARING 常數會定義 preparing 事件物件的 type 屬性值。

注意：這個事件不會經歷「捕捉階段」，而且不管目標是否在顯示清單上，都會直接傳送至目標。

這個事件具有下列屬性：

相關 API 元素

Event.REMOVED 常數會定義 removed 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.REMOVED_FROM_STAGE 常數會定義 removedFromStage 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.RENDER 常數會定義 render 事件物件的 type 屬性值。

注意：這個事件沒有「捕捉階段」也沒有「反昇階段」，這表示事件偵聽程式必須直接加入至任何可能的目標，不論目標是否在顯示清單上。

這個事件具有下列屬性：

相關 API 元素

Event.RESIZE 常數會定義 resize 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.SCROLL 常數會定義 scroll 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.SELECT 常數會定義 select 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.SELECT_ALL 常數會定義 selectAll 事件物件的 type 屬性值。

這個事件具有下列屬性：

注意：TextField 物件不會傳送 clear、copy、cut、paste 或 selectAll 事件。TextField 物件一定會在快顯選單中加入「剪下」、「複製」、「貼上」、「清除」與「全選」命令。您無法將這些命令從 TextField 物件的快顯選單中移除。對於 TextField 物件，選擇這些命令 (或它們的鍵盤相對按鍵) 並不會產生 clear、copy、cut、paste 或 selectAll 事件。不過，其他延伸 InteractiveObject 類別的類別 (包括使用 Flash 文字引擎 (FTE) 建立的組件)，將會傳送這些事件以回應鍵盤快速鍵與快顯選單等使用者動作。

相關 API 元素

Event.SOUND_COMPLETE 常數會定義 soundComplete 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.STANDARD_ERROR_CLOSE 常數會定義 standardErrorClose 事件物件的 type 屬性值。

這個事件具有下列屬性：

Event.STANDARD_INPUT_CLOSE 常數會定義 standardInputClose 事件物件的 type 屬性值。

這個事件具有下列屬性：

Event.STANDARD_OUTPUT_CLOSE 常數會定義 standardOutputClose 事件物件的 type 屬性值。

這個事件具有下列屬性：

Event.SUSPEND 常數會定義 suspend 事件物件的 type 屬性值。這個事件只在 AIR iOS 上傳送。

這個事件具有下列屬性：

相關 API 元素

Event.TAB_CHILDREN_CHANGE 常數會定義 tabChildrenChange 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.TAB_ENABLED_CHANGE 常數會定義 tabEnabledChange 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.TAB_INDEX_CHANGE 常數會定義 tabIndexChange 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.TEXT_INTERACTION_MODE_CHANGE 常數會定義 interaction mode 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.TEXTURE_READY 常數會定義 textureReady 事件物件的 type 屬性值。Texture 和 CubeTexture 物件會傳送這個事件，以發出非同步上傳已完成的訊號。在 Texture 或 CubeTexture 上使用 uploadCompressedTextureFromByteArray() 方法，即可要求非同步上傳。這個事件既不會反昇，也不是可取消的。

相關 API 元素

Event.UNLOAD 常數會定義 unload 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.USER_IDLE 常數會定義 userIdle 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.USER_PRESENT 常數會定義 userPresent 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.VIDEO_FRAME 常數會定義 videoFrame 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

Event.WORKER_STATE 常數會定義 workerState 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素