Event

套件	flash.events
類別	public class Event
繼承	Event Object
子類別	AccelerometerEvent, ActionSelectedEvent, ActivityEvent, AdvancedDataGridEvent, AdvancedDataGridHeaderShiftEvent, AdvancedDataGridItemSelectEvent, AIREvent, AlternativeAudioEvent, AnnotationParseEvent, AssetActionCompleteEvent, AssetActionCompleteEvent, AssetActionEvent, AssetActionsChangeEvent, AssetValidationEvent, AttachmentEvent, AudioEvent, AudioOutputChangeEvent, AuthenticationEvent, AutomationAirEvent, AutomationEvent, AutomationFlexNativeMenuEvent, AutomationRecordEvent, AutomationReplayEvent, AVDictionaryDataEvent, AVHTTPStatusEvent, AVPauseAtPeriodEndEvent, BaseEvent, BrowserChangeEvent, BrowserInvokeEvent, BufferEvent, BundleEvent, CalendarLayoutChangeEvent, CaptionChangeEvent, CaptionTargetEvent, ChannelEvent, ChartSelectionChangeEvent, ChildExistenceChangedEvent, CloseEvent, CollectionEvent, ColorPickerEvent, ColorPickerEvent, ComponentEvent, CompositionCompleteEvent, ComputationErrorEvent, ConflictEvent, ContainerChangeEvent, ContextMenuEvent, CubeEvent, CuePointEvent, DamageEvent, DataChangeEvent, DataConflictEvent, DataElementsPanelToolBarEvent, DatagramSocketDataEvent, DataGridEvent, DateChooserEvent, DCTEvent, DDInstanceValueChangeEvent, DeviceRotationEvent, DisplayObjectEvent, DividerEvent, DNSResolverEvent, DocumentPodEvent, DRMAuthenticateEvent, DRMAuthenticationCompleteEvent, DRMDeviceGroupEvent, DRMEvent, DRMLicenseRequestEvent, DRMMetadataEvent, DRMReturnVoucherCompleteEvent, DRMStatusEvent, DropdownEvent, DropDownEvent, DVREvent, DynamicEvent, DynamicStreamEvent, EffectEvent, ElementExistenceEvent, ErrorEvent, ExpressionBuilderEvent, ExpressionEvent, ExpressionInsertEvent, ExpressionRegistrationFailureEvent, ExpressionRegistrationSuccessEvent, ExpressionsPanelToolBarEvent, ExpressionValueChangeEvent, FileEvent, FileEvent, FileListEvent, FlexEvent, FlexNativeMenuEvent, FlowElementMouseEvent, FlowOperationEvent, FocusEvent, FunctionFamilyProviderEvent, FunctionsPanelToolBarEvent, GAEvent, GameInputEvent, GanttActionEvent, GanttEvent, GeolocationEvent, GestureEvent, GridCaretEvent, GridItemEditorEvent, GridSelectionEvent, GridSortEvent, HTMLUncaughtScriptExceptionEvent, HTTPStatusEvent, IKEvent, IndexChangedEvent, IndexChangeEvent, InterManagerRequest, InvokeEvent, ItemClickEvent, KeyboardEvent, LabelEditorEvent, LayoutEvent, LayoutEvent, ListEvent, ListEvent, ListItemSelectEvent, LiveCycleEvent, LiveCycleFaultEvent, LoaderEvent, LoaderInvalidationEvent, LoadEvent, LocationChangeEvent, LogEvent, MarshalledAutomationEvent, MediaElementEvent, MediaErrorEvent, MediaEvent, MediaFactoryEvent, MediaPlayerCapabilityChangeEvent, MediaPlayerStateChangeEvent, MenuShowEvent, Message, MessageEvent, MessageFaultEvent, MetadataEvent, MetadataEvent, MetadataEvent, MotionEvent, MouseEvent, MoveEvent, NativeProcessExitEvent, NativeWindowBoundsEvent, NativeWindowDisplayStateEvent, NetConnectionFactoryEvent, NetDataEvent, NetMonitorEvent, NetStatusEvent, NumericStepperEvent, OptionMenuEvent, OutputProgressEvent, PackageDefinitionLoadFailedEvent, PackageDefinitionReadyEvent, PackageObjectReadyEvent, PermissionEvent, PlayEvent, PluginNotInstalledEvent, PopUpEvent, PreviewEvent, PRMErrorEvent, ProcessComponentEvent, ProgressEvent, ProjectEvent, PropertyChangeEvent, PropertyLoadEvent, QoSInfoEvent, RCAErrorEvent, ReferenceChangedEvent, RelationEvent, RemoteNotificationEvent, RendererExistenceEvent, Request, RequestAwareEvent, ResizeEvent, RSLEvent, SampleDataEvent, SandboxMouseEvent, ScaleChangedEvent, SchedulesStateEvent, ScrollEvent, ScrollEvent, SearchEvent, SearchEvent, SeekEvent, SelectionEvent, SerialElementEvent, ServerSocketConnectEvent, ServiceEvent, SessionFaultEvent, SessionResultEvent, ShaderEvent, SliderEvent, SliderEvent, SoftKeyboardEvent, SoundEvent, SparkDataGridItemSelectEvent, SparkListItemSelectEvent, SparkValueChangeAutomationEvent, SQLEvent, SQLUpdateEvent, StageEvent, StageOrientationEvent, StageParticipantEvent, StageVideoAvailabilityEvent, StageVideoEvent, StartpointEvent, StateChangeEvent, StatusChangeEvent, StatusEvent, StorageVolumeChangeEvent, SwfAppButtonEvent, SwfAppEvent, SWFBridgeEvent, SWFBridgeRequest, SwfDataEvent, SyncEvent, TabLayoutEvent, TaskCompletedEvent, TaskManagerEvent, TaskManagerFaultEvent, TaskPropertyChangedEvent, TeamPodEvent, TemplateEvent, TextEvent, TextLayoutEvent, TextOperationEvent, TextSelectionEvent, ThrottleEvent, TimeEvent, TimerEvent, TitleWindowBoundsEvent, ToolTipEvent, TouchEvent, TouchInteractionEvent, TrackBaseEvent, TreeEvent, TweenEvent, TweenEvent, UpdateCompleteEvent, UpdateEvent, UploadEvent, UserEvent, UserSelectedEvent, ValidationResultEvent, VariableChangeEvent, VersionEvent, VideoEvent, VideoEvent, VideoEvent, VideoTextureEvent, ViewNavigatorEvent, VsyncStateChangeAvailabilityEvent, WorkItemEvent, XFADataLoadFailedEvent, XFADataReadyEvent, XFADataSavedEvent, XFADataSaveFailedEvent, XMLDataReadyEvent, XMLLoadEvent

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

在建立 Event 物件時，Event 類別可以當作基底類別來使用，而當發生事件時，Event 物件會被當作參數傳遞至事件偵聽程式。

Event 類別的屬性帶有與事件相關的基本資訊，例如事件的類型，或者是否可以取消事件的預設行為指令。就許多事件而言，例如 Event 類別常數所代表的事件，這個基本資訊就夠用了。然而，其它事件可能需要更詳細的資訊才夠。例如，與按一下滑鼠相關聯的事件，會需要包含有關按一下事件的發生位置，以及按一下事件發生期間是否按下任何按鈕等額外資訊。您可以擴充 Event 類別，藉此將這類額外資訊傳遞至事件偵聽程式，MouseEvent 類別就是如此作業。 ActionScript 3.0 API 會針對需要其它資訊的一般事件定義數個 Event 子類別。在每個類別的說明文件中，都會詳述與每個 Event 子類別相關聯的事件。

Event 類別的方法可以運用在事件偵聽程式函數上，以影響事件物件的行為指令。某些事件擁有相關聯的預設行為指令。例如，doubleClick 事件所擁有的相關預設行為指令會在事件發生時，反白標示滑鼠指標底下的文字。您的事件偵聽程式可以呼叫 preventDefault() 方法來取消這個行為指令。您也可以呼叫 stopPropagation() 或 stopImmediatePropagation() 方法，讓目前的事件偵聽程式成為最後處理事件的偵聽程式。

其他資訊來源包括：

Ted Patrick 這篇部落格文章具體描述了事件、程式碼執行以及執行階段呈現的時機：Flash Player Mental Model - The Elastic Racetrack (Flash Player 心智模式 - 彈性車道)。
Johannes Tacskovics 這篇部落格文章會提供您影格事件的相關資訊，例如 ENTER_FRAME、EXIT_FRAME：The MovieClip Lifecycle (影片片段的週期)。
Trevor McCauley 的文章提供 ActionScript 作業順序的說明：Order of Operations in ActionScript (ActionScript 的作業順序)。
Matt Przybylski 這篇部落格文章提供有關建立自訂事件的說明：AS3: Custom Events (AS3: 自訂事件)。

檢視範例

相關 API 元素

flash.events.EventDispatcher

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		bubbles : Boolean [唯讀] 指出事件是否為反昇事件。	Event
		cancelable : Boolean [唯讀] 指出是否可避免與事件相關聯的行為指令。	Event
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		currentTarget : Object [唯讀] 正主動使用事件偵聽程式處理 Event 物件的物件。	Event
		eventPhase : uint [唯讀] 事件流程中的目前階段。	Event
		target : Object [唯讀] 事件目標。	Event
		type : String [唯讀] 事件類型。	Event

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		Event(type:String, bubbles:Boolean = false, cancelable:Boolean = false) 建立 Event 物件，以當作參數傳遞至事件偵聽程式。	Event
		clone():Event 複製 Event 子類別的實體。	Event
		formatToString(className:String, ... arguments):String 公用程式函數，可用來實作自訂 ActionScript 3.0 Event 類別中的 toString() 方法。	Event
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		isDefaultPrevented():Boolean 檢查是否已經對事件呼叫 preventDefault() 方法。	Event
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		preventDefault():void 如果可以取消事件的預設行為指令，則取消該行為指令。	Event
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		stopImmediatePropagation():void 避免處理事件流程中，目前節點以及任何後續節點中的任何事件偵聽程式。	Event
		stopPropagation():void 避免處理接續在事件流程中的目前節點之後，後續節點中的任何事件偵聽程式。	Event
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String 傳回包含 Event 物件所有屬性的字串。	Event
		valueOf():Object 會傳回指定之物件的基本值。	Object

公用常數

	常數		定義自
		ACTIVATE : String = "activate" [靜態] ACTIVATE 常數會定義 activate 事件物件的 type 屬性值。	Event
		ADDED : String = "added" [靜態] Event.ADDED 常數會定義 added 事件物件的 type 屬性值。	Event
		ADDED_TO_STAGE : String = "addedToStage" [靜態] Event.ADDED_TO_STAGE 常數會定義 addedToStage 事件物件的 type 屬性值。	Event
		BROWSER_ZOOM_CHANGE : String = "browserZoomChange" [靜態] Event.BROWSER_ZOOM_CHANGE 常數會定義 browserZoomChange 事件物件的 type 屬性值。	Event
		CANCEL : String = "cancel" [靜態] Event.CANCEL 常數會定義 cancel 事件物件的 type 屬性值。	Event
		CHANGE : String = "change" [靜態] Event.CHANGE 常數會定義 change 事件物件的 type 屬性值。	Event
		CHANNEL_MESSAGE : String = "channelMessage" [靜態] Event.CHANNEL_MESSAGE 常數會定義 channelMessage 事件物件的 type 屬性值。	Event
		CHANNEL_STATE : String = "channelState" [靜態] Event.CHANNEL_STATE 常數會定義 channelState 事件物件的 type 屬性值。	Event
		CLEAR : String = "clear" [靜態] Event.CLEAR 常數會定義 clear 事件物件的 type 屬性值。	Event
		CLOSE : String = "close" [靜態] Event.CLOSE 常數會定義 close 事件物件的 type 屬性值。	Event
		CLOSING : String = "closing" [靜態] Event.CLOSING 常數會定義 closing 事件物件的 type 屬性值。	Event
		COMPLETE : String = "complete" [靜態] Event.COMPLETE 常數會定義 complete 事件物件的 type 屬性值。	Event
		CONNECT : String = "connect" [靜態] Event.CONNECT 常數會定義 connect 事件物件的 type 屬性值。	Event
		CONTEXT3D_CREATE : String = "context3DCreate" [靜態] Event.CONTEXT3D_CREATE 常數定義了 context3Dcreate 事件物件的 type 屬性值。	Event
		COPY : String = "copy" [靜態] 定義 copy 事件物件的 type 屬性值。	Event
		CUT : String = "cut" [靜態] 定義 cut 事件物件的 type 屬性值。	Event
		DEACTIVATE : String = "deactivate" [靜態] Event.DEACTIVATE 常數會定義 deactivate 事件物件的 type 屬性值。	Event
		DISPLAYING : String = "displaying" [靜態] Event.DISPLAYING 常數會定義 displaying 事件物件的 type 屬性值。	Event
		ENTER_FRAME : String = "enterFrame" [靜態] Event.ENTER_FRAME 常數會定義 enterFrame 事件物件的 type 屬性值。	Event
		EXIT_FRAME : String = "exitFrame" [靜態] Event.EXIT_FRAME 常數會定義 exitFrame 事件物件的 type 屬性值。	Event
		EXITING : String = "exiting" [靜態] Event.EXITING 常數會定義 exiting 事件物件的 type 屬性值。	Event
		FRAME_CONSTRUCTED : String = "frameConstructed" [靜態] Event.FRAME_CONSTRUCTED 常數會定義 frameConstructed 事件物件的 type 屬性值。	Event
		FRAME_LABEL : String = "frameLabel" [靜態] Event.FRAME_LABEL 常數會定義 frameLabel 事件物件的 type 屬性值。	Event
		FULLSCREEN : String = "fullScreen" [靜態] Event.FULL_SCREEN 常數會定義 fullScreen 事件物件的 type 屬性值。	Event
		HTML_BOUNDS_CHANGE : String = "htmlBoundsChange" [靜態] Event.HTML_BOUNDS_CHANGE 常數會定義 htmlBoundsChange 事件物件的 type 屬性值。	Event
		HTML_DOM_INITIALIZE : String = "htmlDOMInitialize" [靜態] Event.HTML_DOM_INITIALIZE 常數會定義 htmlDOMInitialize 事件物件的 type 屬性值。	Event
		HTML_RENDER : String = "htmlRender" [靜態] Event.HTML_RENDER 常數會定義 htmlRender 事件物件的 type 屬性值。	Event
		ID3 : String = "id3" [靜態] Event.ID3 常數會定義 id3 事件物件的 type 屬性值。	Event
		INIT : String = "init" [靜態] Event.INIT 常數會定義 init 事件物件的 type 屬性值。	Event
		LOCATION_CHANGE : String = "locationChange" [靜態] Event.LOCATION_CHANGE 常數會定義 locationChange 事件物件的 type 屬性值。	Event
		MOUSE_LEAVE : String = "mouseLeave" [靜態] Event.MOUSE_LEAVE 常數會定義 mouseLeave 事件物件的 type 屬性值。	Event
		NETWORK_CHANGE : String = "networkChange" [靜態] Event.NETWORK_CHANGE 常數會定義 networkChange 事件物件的 type 屬性值。	Event
		OPEN : String = "open" [靜態] Event.OPEN 常數會定義 open 事件物件的 type 屬性值。	Event
		PASTE : String = "paste" [靜態] Event.PASTE 常數會定義 paste 事件物件的 type 屬性值。	Event
		PREPARING : String = "preparing" [靜態] Event.PREPARING 常數會定義 preparing 事件物件的 type 屬性值。	Event
		REMOVED : String = "removed" [靜態] Event.REMOVED 常數會定義 removed 事件物件的 type 屬性值。	Event
		REMOVED_FROM_STAGE : String = "removedFromStage" [靜態] Event.REMOVED_FROM_STAGE 常數會定義 removedFromStage 事件物件的 type 屬性值。	Event
		RENDER : String = "render" [靜態] Event.RENDER 常數會定義 render 事件物件的 type 屬性值。	Event
		RESIZE : String = "resize" [靜態] Event.RESIZE 常數會定義 resize 事件物件的 type 屬性值。	Event
		SCROLL : String = "scroll" [靜態] Event.SCROLL 常數會定義 scroll 事件物件的 type 屬性值。	Event
		SELECT : String = "select" [靜態] Event.SELECT 常數會定義 select 事件物件的 type 屬性值。	Event
		SELECT_ALL : String = "selectAll" [靜態] Event.SELECT_ALL 常數會定義 selectAll 事件物件的 type 屬性值。	Event
		SOUND_COMPLETE : String = "soundComplete" [靜態] Event.SOUND_COMPLETE 常數會定義 soundComplete 事件物件的 type 屬性值。	Event
		STANDARD_ERROR_CLOSE : String = "standardErrorClose" [靜態] Event.STANDARD_ERROR_CLOSE 常數會定義 standardErrorClose 事件物件的 type 屬性值。	Event
		STANDARD_INPUT_CLOSE : String = "standardInputClose" [靜態] Event.STANDARD_INPUT_CLOSE 常數會定義 standardInputClose 事件物件的 type 屬性值。	Event
		STANDARD_OUTPUT_CLOSE : String = "standardOutputClose" [靜態] Event.STANDARD_OUTPUT_CLOSE 常數會定義 standardOutputClose 事件物件的 type 屬性值。	Event
		SUSPEND : String = "suspend" [靜態] Event.SUSPEND 常數會定義 suspend 事件物件的 type 屬性值。	Event
		TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [靜態] Event.TAB_CHILDREN_CHANGE 常數會定義 tabChildrenChange 事件物件的 type 屬性值。	Event
		TAB_ENABLED_CHANGE : String = "tabEnabledChange" [靜態] Event.TAB_ENABLED_CHANGE 常數會定義 tabEnabledChange 事件物件的 type 屬性值。	Event
		TAB_INDEX_CHANGE : String = "tabIndexChange" [靜態] Event.TAB_INDEX_CHANGE 常數會定義 tabIndexChange 事件物件的 type 屬性值。	Event
		TEXT_INTERACTION_MODE_CHANGE : String = "textInteractionModeChange" [靜態] Event.TEXT_INTERACTION_MODE_CHANGE 常數會定義 interaction mode 事件物件的 type 屬性值。	Event
		TEXTURE_READY : String = "textureReady" [靜態] Event.TEXTURE_READY 常數會定義 textureReady 事件物件的 type 屬性值。	Event
		UNLOAD : String = "unload" [靜態] Event.UNLOAD 常數會定義 unload 事件物件的 type 屬性值。	Event
		USER_IDLE : String = "userIdle" [靜態] Event.USER_IDLE 常數會定義 userIdle 事件物件的 type 屬性值。	Event
		USER_PRESENT : String = "userPresent" [靜態] Event.USER_PRESENT 常數會定義 userPresent 事件物件的 type 屬性值。	Event
		VIDEO_FRAME : String = "videoFrame" [靜態] Event.VIDEO_FRAME 常數會定義 videoFrame 事件物件的 type 屬性值。	Event
		WORKER_STATE : String = "workerState" [靜態] Event.WORKER_STATE 常數會定義 workerState 事件物件的 type 屬性值。	Event

屬性詳細資訊

bubbles

屬性

bubbles:Boolean [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

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

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

實作
public function get bubbles():Boolean

cancelable

屬性

cancelable:Boolean [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

實作
public function get cancelable():Boolean

相關 API 元素

Event.preventDefault()

currentTarget

屬性

currentTarget:Object [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

實作
public function get currentTarget():Object

eventPhase

屬性

eventPhase:uint [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

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

實作
public function get eventPhase():uint

target

屬性

target:Object [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

實作
public function get target():Object

type

屬性

type:String [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

實作
public function get type():String

建構函式詳細資料

()

建構函式

public function Event(type:String, bubbles:Boolean = false, cancelable:Boolean = false)

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

參數

	`type:String` — 可當作 `Event.type` 來存取的事件類型。

	`bubbles:Boolean` (default = `false`) — 判斷 Event 物件是否參與事件流程的反昇階段。預設值是 `false`。

	`cancelable:Boolean` (default = `false`) — 判斷是否可以取消 Event 物件。預設值為 `false`。

方法詳細資訊

clone

()

方法

public function clone():Event

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

複製 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);
        }
     }

傳回值

Event — 具有和原始物件完全相同的新 Event 物件。

formatToString

()

方法

public function formatToString(className:String, ... arguments):String

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

公用程式函數，可用來實作自訂 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"); 
	    }
	 }

參數

	`className:String` — 自訂 Event 類別的名稱。在上一個範例中，`className` 參數為 `PingEvent`。

	`... arguments` — Event 類別的屬性，以及加入自訂 Event 類別的屬性。在上一個範例中，`...arguments` 參數包括了 `type`、`bubbles`、`cancelable`、`eventPhase`，以及 `URL`。

傳回值

String — 自訂 Event 類別的名稱，以及 ...arguments 參數的 String 值。

isDefaultPrevented

()

方法

public function isDefaultPrevented():Boolean

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

傳回值

Boolean — 如果已呼叫 preventDefault()，則會傳回 true；否則會傳回 false。

相關 API 元素

flash.events.Event.preventDefault()

preventDefault

()

方法

public function preventDefault():void

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

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

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

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

stopImmediatePropagation

()

方法

public function stopImmediatePropagation():void

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

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

stopPropagation

()

方法

public function stopPropagation():void

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

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

toString

()

方法

public function toString():String

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

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

傳回值

String — 包含 Event 物件所有屬性的字串。

常數詳細資訊

ACTIVATE

常數

public static const ACTIVATE:String = "activate"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

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

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	具有為 `activate` 事件註冊之偵聽程式的任何 DisplayObject 實體。

ADDED

常數

public static const ADDED:String = "added"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`true`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	正要加入顯示清單中的 DisplayObject 實體。 `target` 不會永遠都是顯示清單中註冊事件偵聽程式的物件。請使用 `currentTarget` 屬性，存取目前正在處理該事件之顯示清單中的物件。

ADDED_TO_STAGE

常數

public static const ADDED_TO_STAGE:String = "addedToStage"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	加入至舞台上顯示清單的 DisplayObject 實體，方式為直接加入或透過加入包含 DisplayObject 實體的子樹狀結構來加入。如果直接加入 DisplayObject 實體，便會在此事件之前發生 `added` 事件。

BROWSER_ZOOM_CHANGE

常數

public static const BROWSER_ZOOM_CHANGE:String = "browserZoomChange"

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 15, AIR 15

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	Stage 實體。

相關 API 元素

flash.display.Stage.browserZoomChange

CANCEL

常數

public static const CANCEL:String = "cancel"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	在其上取消作業之物件的參照。

相關 API 元素

flash.net.FileReference.cancel

CHANGE

常數

public static const CHANGE:String = "change"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`true`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	其值遭到修改的物件。 `target` 不會永遠都是顯示清單中註冊事件偵聽程式的物件。請使用 `currentTarget` 屬性，存取目前正在處理該事件之顯示清單中的物件。

CHANNEL_MESSAGE

常數

public static const CHANNEL_MESSAGE:String = "channelMessage"

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 11.4, AIR 3.4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	傳送此事件的物件。

CHANNEL_STATE

常數

public static const CHANNEL_STATE:String = "channelState"

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 11.4, AIR 3.4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	傳送此事件的物件。

相關 API 元素

flash.system.Worker.channelState

CLEAR

常數

public static const CLEAR:String = "clear"

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10, AIR 1.5, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	具有為 `clear` 事件註冊之偵聽程式的任何 InteractiveObject 實體。

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

相關 API 元素

flash.display.InteractiveObject.clear

CLOSE

常數

public static const CLOSE:String = "close"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	其連線已關閉的物件。

CLOSING

常數

public static const CLOSING:String = "closing"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`true`；取消此事件物件將停止關閉作業。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	其連線將關閉的物件。

相關 API 元素

flash.display.NativeWindow.closing

COMPLETE

常數

public static const COMPLETE:String = "complete"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	已完成載入的網路物件。

CONNECT

常數

public static const CONNECT:String = "connect"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	已建立網路連線的 Socket 或 XMLSocket 物件。

CONTEXT3D_CREATE

常數

public static const CONTEXT3D_CREATE:String = "context3DCreate"

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 11, AIR 3

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

相關 API 元素

Stage3D

COPY

常數

public static const COPY:String = "copy"

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10, AIR 1.5, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	具有為 `copy` 事件註冊之偵聽程式的任何 InteractiveObject 實體。

相關 API 元素

flash.display.InteractiveObject.copy

CUT

常數

public static const CUT:String = "cut"

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10, AIR 1.5, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	具有為 `cut` 事件註冊之偵聽程式的任何 InteractiveObject 實體。

相關 API 元素

flash.display.InteractiveObject.cut

DEACTIVATE

常數

public static const DEACTIVATE:String = "deactivate"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

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

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	具有為 `deactivate` 事件註冊之偵聽程式的任何 DisplayObject 實體。

DISPLAYING

常數

public static const DISPLAYING:String = "displaying"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Lite 4

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

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	將要顯示的物件。

ENTER_FRAME

常數

public static const ENTER_FRAME:String = "enterFrame"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	具有為 `enterFrame` 事件註冊之偵聽程式的任何 DisplayObject 實體。

相關 API 元素

flash.display.DisplayObject.enterFrame

EXIT_FRAME

常數

public static const EXIT_FRAME:String = "exitFrame"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	具有為 `enterFrame` 事件註冊之偵聽程式的任何 DisplayObject 實體。

相關 API 元素

flash.display.DisplayObject.exitFrame

EXITING

常數

public static const EXITING:String = "exiting"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`true`；取消此事件物件將停止結束作業。
`currentTarget`	NativeApplication 物件。
`target`	NativeApplication 物件。

相關 API 元素

flash.desktop.NativeApplication.exiting

FRAME_CONSTRUCTED

常數

public static const FRAME_CONSTRUCTED:String = "frameConstructed"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	具有為 `frameConstructed` 事件註冊之偵聽程式的任何 DisplayObject 實體。

FRAME_LABEL

常數

public static const FRAME_LABEL:String = "frameLabel"

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 11.3, AIR 3.3

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

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的 FrameLabel 物件。
`target`	具有為 `frameLabel` 事件註冊之偵聽程式的任何 FrameLabel 實體。

相關 API 元素

flash.display.FrameLabel.frameLabel

FULLSCREEN

常數

public static const FULLSCREEN:String = "fullScreen"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	Stage 物件。

相關 API 元素

flash.display.Stage.fullScreen

HTML_BOUNDS_CHANGE

常數

public static const HTML_BOUNDS_CHANGE:String = "htmlBoundsChange"

執行階段版本:

AIR 1.0, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	HTMLLoader 物件。
`target`	HTMLLoader 物件。

相關 API 元素

htmlBoundsChange event

HTML_DOM_INITIALIZE

常數

public static const HTML_DOM_INITIALIZE:String = "htmlDOMInitialize"

執行階段版本:

AIR 1.0, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	HTMLLoader 物件。
`target`	HTMLLoader 物件。

相關 API 元素

htmlDOMInitialize event

HTML_RENDER

常數

public static const HTML_RENDER:String = "htmlRender"

執行階段版本:

AIR 1.0, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	HTMLLoader 物件。
`target`	HTMLLoader 物件。

相關 API 元素

htmlRender event

ID3

常數

public static const ID3:String = "id3"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	載入目前可使用 ID3 資料之 MP3 的 Sound 物件。 `target` 不會永遠都是顯示清單中註冊事件偵聽程式的物件。請使用 `currentTarget` 屬性，存取目前正在處理該事件之顯示清單中的物件。

相關 API 元素

flash.media.Sound.id3

INIT

常數

public static const INIT:String = "init"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	與所載入之 SWF 檔相關聯的 LoaderInfo 物件。

相關 API 元素

flash.display.LoaderInfo.init

LOCATION_CHANGE

常數

public static const LOCATION_CHANGE:String = "locationChange"

執行階段版本:

AIR 1.0, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	HTMLLoader 物件。
`target`	HTMLLoader 物件。

相關 API 元素

locationChange event

MOUSE_LEAVE

常數

public static const MOUSE_LEAVE:String = "mouseLeave"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	Stage 物件。 `target` 不會永遠都是顯示清單中註冊事件偵聽程式的物件。請使用 `currentTarget` 屬性，存取目前正在處理該事件之顯示清單中的物件。

NETWORK_CHANGE

常數

public static const NETWORK_CHANGE:String = "networkChange"

執行階段版本:

AIR 1.0, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	NativeApplication 物件。

OPEN

常數

public static const OPEN:String = "open"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	已開啟連線的網路物件。

PASTE

常數

public static const PASTE:String = "paste"

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10, AIR 1.5, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`true` (AIR 執行階段則為 `false`)。
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	具有為 `paste` 事件註冊之偵聽程式的任何 InteractiveObject 實體。

相關 API 元素

flash.display.InteractiveObject.paste

PREPARING

常數

public static const PREPARING:String = "preparing"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 2.6

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

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`
`currentTarget`	傳送此事件的物件。
`target`	傳送此事件的物件。

REMOVED

常數

public static const REMOVED:String = "removed"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`true`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	要從顯示清單中移除的 DisplayObject 實體。 `target` 不會永遠都是顯示清單中註冊事件偵聽程式的物件。請使用 `currentTarget` 屬性，存取目前正在處理該事件之顯示清單中的物件。

REMOVED_FROM_STAGE

常數

public static const REMOVED_FROM_STAGE:String = "removedFromStage"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	從舞台上顯示清單中移除的 DisplayObject 實體，方式為直接移除或透過移除包含 DisplayObject 實體的子樹狀結構來移除。如果直接移除 DisplayObject 實體，便會在此事件之前發生 `removed` 事件。

RENDER

常數

public static const RENDER:String = "render"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；無法取消預設的行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	具有為 `render` 事件註冊之偵聽程式的任何 DisplayObject 實體。

RESIZE

常數

public static const RESIZE:String = "resize"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	Stage 物件。

相關 API 元素

flash.display.Stage.resize

SCROLL

常數

public static const SCROLL:String = "scroll"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	已經過捲動的 TextField 物件。這個 `target` 屬性並非永遠都是註冊事件偵聽之顯示清單中的物件。請使用 `currentTarget` 屬性，存取目前正在處理該事件之顯示清單中的物件。

SELECT

常數

public static const SELECT:String = "select"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	已經選取項目的物件。

SELECT_ALL

常數

public static const SELECT_ALL:String = "selectAll"

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10, AIR 1.5, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	具有為 `selectAll` 事件註冊之偵聽程式的任何 InteractiveObject 實體。

SOUND_COMPLETE

常數

public static const SOUND_COMPLETE:String = "soundComplete"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	聲音已完成播放的 SoundChannel 物件。

相關 API 元素

flash.media.SoundChannel.soundComplete

STANDARD_ERROR_CLOSE

常數

public static const STANDARD_ERROR_CLOSE:String = "standardErrorClose"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 2, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`target`	NativeProcess 物件。

STANDARD_INPUT_CLOSE

常數

public static const STANDARD_INPUT_CLOSE:String = "standardInputClose"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 2, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`target`	NativeProcess 物件。

STANDARD_OUTPUT_CLOSE

常數

public static const STANDARD_OUTPUT_CLOSE:String = "standardOutputClose"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 2, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`target`	NativeProcess 物件。

SUSPEND

常數

public static const SUSPEND:String = "suspend"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 3.3

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	NativeApplication 物件。
`target`	NativeApplication 物件。

相關 API 元素

flash.desktop.NativeApplication.suspend

TAB_CHILDREN_CHANGE

常數

public static const TAB_CHILDREN_CHANGE:String = "tabChildrenChange"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`true`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	已變更 tabChildren 旗標的物件。 `target` 不會永遠都是顯示清單中註冊事件偵聽程式的物件。請使用 `currentTarget` 屬性，存取目前正在處理該事件之顯示清單中的物件。

TAB_ENABLED_CHANGE

常數

public static const TAB_ENABLED_CHANGE:String = "tabEnabledChange"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`true`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	已變更 tabEnabled 旗標的 InteractiveObject。 `target` 不會永遠都是顯示清單中註冊事件偵聽程式的物件。請使用 `currentTarget` 屬性，存取目前正在處理該事件之顯示清單中的物件。

TAB_INDEX_CHANGE

常數

public static const TAB_INDEX_CHANGE:String = "tabIndexChange"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`true`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	已變更 tabIndex 的物件。 `target` 不會永遠都是顯示清單中註冊事件偵聽程式的物件。請使用 `currentTarget` 屬性，存取目前正在處理該事件之顯示清單中的物件。

TEXT_INTERACTION_MODE_CHANGE

常數

public static const TEXT_INTERACTION_MODE_CHANGE:String = "textInteractionModeChange"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 11, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	已變更互動模式屬性的 TextField 物件。例如，在 Android 可以透過快顯選單將互動模式變更為 SELECTION。這個 `target` 屬性並非永遠都是註冊事件偵聽之顯示清單中的物件。請使用 `currentTarget` 屬性，存取目前正在處理該事件之顯示清單中的物件。

TEXTURE_READY

常數

public static const TEXTURE_READY:String = "textureReady"

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 11.4, AIR 3.4

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

相關 API 元素

Texture.uploadCompressedTextureFromByteArray()
CubeTexture.uploadCompressedTextureFromByteArray()

UNLOAD

常數

public static const UNLOAD:String = "unload"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	與要取消載入或取代之 SWF 檔相關聯的 LoaderInfo 物件。

相關 API 元素

flash.display.LoaderInfo.unload

USER_IDLE

常數

public static const USER_IDLE:String = "userIdle"

執行階段版本:

AIR 1.0, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`target`	NativeApplication 物件。

USER_PRESENT

常數

public static const USER_PRESENT:String = "userPresent"

執行階段版本:

AIR 1.0, Flash Lite 4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`target`	NativeApplication 物件。

VIDEO_FRAME

常數

public static const VIDEO_FRAME:String = "videoFrame"

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 11.4, AIR 3.4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`target`	傳送此事件的 Camera 物件。

相關 API 元素

flash.media.Camera

WORKER_STATE

常數

public static const WORKER_STATE:String = "workerState"

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 11.4, AIR 3.4

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

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	傳送此事件的物件。

相關 API 元素

flash.system.Worker.workerState

範例如何使用本範例

EventExample.as

下列範例使用 EventExample 類別和 Square 自訂類別來說明如何管理事件的反昇。

package {
    import flash.display.Sprite;
    import flash.events.Event;
    import flash.events.MouseEvent;

    public class EventExample extends Sprite {
        
        public function EventExample() {
            var square_0:Square = new Square(300, 0x336633);
            addChild(square_0);
            
            var square_1:Square = new Square(250, 0x669966);
            square_0.addChild(square_1);

            var square_2:Square = new Square(200, 0x66CC66);
            square_1.addChild(square_2);

            var square_3:Square = new Square(150, 0xAA0000);
            square_3.shouldBubble = false;
            square_2.addChild(square_3);

            var square_4:Square = new Square(100, 0x66FF66);
            square_3.addChild(square_4);

            var square_5:Square = new Square(50, 0xCC0000);
            square_5.shouldBubble = false;
            square_4.addChild(square_5);

            this.addEventListener(MouseEvent.CLICK, clickHandler);
        }
        
        private function clickHandler(e:Event):void {
            trace(">> stage: " + e.type + " event from " + e.target.name + " called on " + this.name);
            trace(">> --------------------------------------------");
        }
    }
}

import flash.display.Sprite;
import flash.events.Event;
import flash.events.MouseEvent;

class Square extends Sprite {
    private var sideLen:int;
    private var color:Number;
    public var shouldBubble:Boolean = true;

    public function Square(sideLen:int, color:Number) {
        this.sideLen = sideLen;
        this.color = color;
        init();
        draw();
    }
        
    private function init():void {
        buttonMode = true;
        this.addEventListener(MouseEvent.CLICK, firstClickHandler);
        this.addEventListener(MouseEvent.CLICK, secondClickHandler);
        this.addEventListener(MouseEvent.CLICK, thirdClickHandler);
    }
        
    private function draw():void {
        this.graphics.beginFill(color);
        this.graphics.drawRect(0, 0, sideLen, sideLen);
    }
        
    private function firstClickHandler(e:Event):void {
        trace(">> 1e: " + e.type + " event from " + e.target.name + " called on " + this.name);
        if(!shouldBubble) {
            e.stopPropagation();
        }
    }

    private function secondClickHandler(e:Event):void {
        trace(">> 2e: " + e.type + " event from " + e.target.name + " called on " + this.name);
        if(!shouldBubble) {
            e.stopImmediatePropagation();
            trace(">> --------------------------------------------");
        }
    }

    private function thirdClickHandler(e:Event):void {
        trace(">> 3e: " + e.type + " event from " + e.target.name + " called on " + this.name);
    }
}

EventExample2.as

下列範例會建立互動式示範，以說明 ADDED 和 ADDED_TO_STAGE 事件之間的差異，以及 REMOVED 和 REMOVED_FROM_STAGE 事件之間的差異。按一下 Sprite 便會將它從舞台移除，也會移除它內部所有的巢狀項目。例如，按一下最大的 Sprite 便會觸發 REMOVED 事件以及三個 REMOVED_FROM_STAGE 事件。

 package {
    import flash.display.Sprite;
    import flash.events.*;

    public class EventExample2 extends Sprite {
        public function EventExample2():void {
            var parentSprite:Sprite = createSprite("parentSprite",200);
            var childSprite:Sprite = createSprite("childSprite",100);
            var childOfChildSprite:Sprite = createSprite("childOfChildSprite",50);
            
            trace(":: Adding to Stage ::");
            this.addChild(parentSprite);
            trace(":: Adding to Stage ::");
            parentSprite.addChild(childSprite);
            trace(":: Adding to Stage ::");
            childSprite.addChild(childOfChildSprite);
        }
        private function createSprite(name:String,size:uint):Sprite {
            trace(":: Creating Sprite ::");
            var newSprite:Sprite = new Sprite();
            newSprite.name = name;
            newSprite.graphics.beginFill(0xFFFFFF * Math.random(),1);
            newSprite.graphics.drawRect(0,0,size,size);
            newSprite.graphics.endFill();
            newSprite.addEventListener(Event.ADDED, spriteAdded);
            newSprite.addEventListener(Event.ADDED_TO_STAGE, spriteAddedToStage);
            newSprite.addEventListener(Event.REMOVED, spriteRemoved);
            newSprite.addEventListener(Event.REMOVED_FROM_STAGE, spriteRemovedFromStage);
            newSprite.addEventListener(MouseEvent.CLICK, remove);
            return newSprite;
        }
        private function remove(event:Event) {
            if(event.target == event.currentTarget) {
                trace(":: Removing Clicked Sprite ::");
                var target:Sprite = Sprite(event.target);
                target.parent.removeChild(target);
            }
        }
        private function spriteRemovedFromStage(event:Event):void {
            trace("REMOVED_FROM_STAGE: " + event.target.name + " : " + event.currentTarget.name);
        }
        private function spriteRemoved(event:Event):void {
            trace("REMOVED: " + event.target.name + " from " + event.currentTarget.name);
        }
        private function spriteAddedToStage(event:Event):void {
            trace("ADDED_TO_STAGE: " + event.target.name + " : " + event.currentTarget.name);
        }
        private function spriteAdded(event:Event):void {
            trace("ADDED: " + event.target.name + " within " + event.currentTarget.name);
        }
    }
}

法律聲明 | 線上隱私權政策

Event - AS3

類別 x

bubbles

cancelable

currentTarget

eventPhase

target

type

Event

clone

formatToString

isDefaultPrevented

preventDefault

stopImmediatePropagation

stopPropagation

toString

ACTIVATE

ADDED

ADDED_TO_STAGE

BROWSER_ZOOM_CHANGE

CANCEL

CHANGE

CHANNEL_MESSAGE

CHANNEL_STATE

CLEAR

CLOSE

CLOSING

COMPLETE

CONNECT

CONTEXT3D_CREATE

COPY

CUT

DEACTIVATE

DISPLAYING

ENTER_FRAME

EXIT_FRAME

EXITING

FRAME_CONSTRUCTED

FRAME_LABEL

FULLSCREEN

HTML_BOUNDS_CHANGE

HTML_DOM_INITIALIZE

HTML_RENDER

ID3

INIT

LOCATION_CHANGE

MOUSE_LEAVE

NETWORK_CHANGE

OPEN

PASTE

PREPARING

REMOVED

REMOVED_FROM_STAGE

RENDER

RESIZE

SCROLL

SELECT

SELECT_ALL

SOUND_COMPLETE

STANDARD_ERROR_CLOSE

STANDARD_INPUT_CLOSE

STANDARD_OUTPUT_CLOSE

SUSPEND

TAB_CHILDREN_CHANGE

TAB_ENABLED_CHANGE

TAB_INDEX_CHANGE

TEXT_INTERACTION_MODE_CHANGE

TEXTURE_READY

UNLOAD

USER_IDLE

USER_PRESENT

VIDEO_FRAME

WORKER_STATE