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()；当您重新调度事件，即调用 dispatchEvent(event)（从正在处理 event 的处理函数）时，EventDispatcher 类会自动调用它。

新的 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 的重置时引发此事件。检查 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 元素