FLEX程序设计--事件和事件机制--Event类

指示事件是否为冒泡事件。如果事件可以冒泡，则此值为 true；否则为 false。

事件冒泡是为 SWF 内容中的显示对象定义的，它使用 ActionScript 3.0 显示对象模型。bubbles 属性仅在 ActionScript 3.0 代码中有效。

发生事件时，该事件在事件流的三个阶段中移动：捕获阶段，该阶段从显示列表层次结构的顶部流动到目标节点之前的节点；目标阶段，该阶段只包括目标节点；冒泡阶段，该阶段从目标节点的后续节点沿显示列表层次结构向上往回流动。

某些事件（例如 activate 和 unload 事件）没有冒泡阶段。对于没有冒泡阶段的事件，bubbles 属性的值为 false。

另请参见

指示是否可以阻止与事件相关联的行为。如果可以取消该行为，则此值为 true；否则为 false。

另请参见

当前正在使用某个事件侦听器处理 Event 对象的对象。例如，如果用户单击“确定”按钮，则当前目标可以是包含该按钮的节点，也可以是它的已为该事件注册了事件侦听器的始祖之一。

另请参见

事件流中的当前阶段。此属性可以包含以下数值：

• 捕获阶段 (EventPhase.CAPTURING_PHASE)。
• 目标阶段 (EventPhase.AT_TARGET)。
• 冒泡阶段 (EventPhase.BUBBLING_PHASE)。

该事件流是为 SWF 内容中的显示对象定义的，它使用 ActionScript 3.0 显示对象模型。eventPhase 属性仅在 ActionScript 3.0 代码中有效。

另请参见

事件目标。此属性包含目标节点。例如，如果用户单击“确定”按钮，则目标节点就是包含该按钮的显示列表节点。

另请参见

事件的类型。类型区分大小写。

另请参见

创建一个作为参数传递给事件侦听器的 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"); 
     }
  }

此方法用于创建将在 SWF 内容中使用的 ActionScript 3.0 类。

参数

检查是否已对事件调用 preventDefault() 方法。如果已调用 preventDefault() 方法，则返回 true；否则返回 false。

另请参见

如果可以取消事件的默认行为，则取消该行为。

许多事件都有默认执行的关联行为。例如，如果用户在文本字段中键入一个字符，则默认行为就是在文本字段中显示该字符。由于可以取消 TextEvent.TEXT_INPUT 事件的默认行为，因此您可以使用 preventDefault() 方法来防止显示该字符。 例如，在用户单击窗口的关闭框时，默认行为是窗口关闭。由于可以取消 closing 事件的默认行为，因此您可以使用 preventDefault() 方法来防止关闭该窗口。

不可取消行为的一个示例是与 Event.REMOVED 事件关联的默认行为，只要 Flash Player 从显示列表中删除显示对象，就会生成该事件。由于无法取消默认行为（删除元素），因此 preventDefault() 方法对此默认行为无效。

您可以使用 Event.cancelable 属性来检查是否可以防止与特定事件关联的默认行为。如果 Event.cancelable 的值为 true，则可以使用 preventDefault() 来取消事件；否则，preventDefault() 无效。

另请参见

防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。此方法会立即生效，并且会影响当前节点中的事件侦听器。相比之下，在当前节点中的所有事件侦听器都完成处理之前，stopPropagation() 方法不会生效。

注意：此方法不会取消与此事件相关联的行为；有关此功能的信息，请参阅 preventDefault()。

该事件流是为 SWF 内容中的显示对象定义的，它使用 ActionScript 3.0 显示对象模型。

另请参见

防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。此方法不会影响当前节点 (currentTarget) 中的任何事件侦听器。相比之下，stopImmediatePropagation() 方法可以防止对当前节点中和后续节点中的事件侦听器进行处理。对此方法的其它调用没有任何效果。可以在事件流的任何阶段中调用此方法。

注意：此方法不会取消与此事件相关联的行为；有关此功能的信息，请参阅 preventDefault()。

该事件流是为 SWF 内容中的显示对象定义的，它使用 ActionScript 3.0 显示对象模型。

另请参见

返回一个字符串，其中包含 Event 对象的所有属性。字符串的格式如下：

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

另请参见

ACTIVATE 常量定义 activate 事件对象的 type 属性的值。

注意：此事件既不具有“捕获阶段”也不具有“冒泡阶段”，这意味着必须直接将事件侦听器添加到任何潜在的目标，而无论目标是否位于显示列表中。

此事件具有以下属性：

另请参见

Event.ADDED 常量定义 added 事件对象的 type 属性值。

added 事件适用于 ActionScript 3.0 显示列表并且与 JavaScript 代码无关。

此事件具有以下属性：

另请参见

Event.ADDED_TO_STAGE 常量定义 addedToStage 事件对象的 type 属性值。

addedToStage 事件适用于 ActionScript 3.0 显示列表并且与 JavaScript 代码无关。

此事件具有以下属性：

另请参见

Event.CANCEL 常量定义 cancel 事件对象的 type 属性的值。

此事件具有以下属性：

另请参见

Event.CHANGE 常量定义 change 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

Event.CLEAR 常量定义 clear 事件对象的 type 属性的值。

此事件具有以下属性：

另请参见

Event.CLOSE 常量定义 close 事件对象的 type 属性的值。

此事件具有以下属性：

另请参见

Event.CLOSING 常量定义 closing 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

Event.COMPLETE 常量定义 complete 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

Event.CONNECT 常量定义 connect 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

定义 copy 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

定义 cut 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

Event.DEACTIVATE 常量定义 deactivate 事件对象的 type 属性值。

注意：此事件既不具有“捕获阶段”也不具有“冒泡阶段”，这意味着必须直接将事件侦听器添加到任何潜在的目标，而无论目标是否位于显示列表中。

此事件具有以下属性：

另请参见

Event.DISPLAYING 常量定义 displaying 事件对象的 type 属性值。

注意：无论目标是否出现在显示列表中，此事件都不会通过“捕获阶段”，而是被直接调度给此目标。

此事件具有以下属性：

另请参见

Event.ENTER_FRAME 常量定义 enterFrame 事件对象的 type 属性值。

注意：此事件既不具有“捕获阶段”也不具有“冒泡阶段”，这意味着必须直接将事件侦听器添加到任何潜在的目标，而无论目标是否位于显示列表中。

此事件具有以下属性：

另请参见

Event.EXIT_FRAME 常量定义 exitFrame 事件对象的 type 属性的值。

注意：此事件既不具有“捕获阶段”也不具有“冒泡阶段”，这意味着必须直接将事件侦听器添加到任何潜在的目标，而无论目标是否位于显示列表中。

此事件具有以下属性：

另请参见

Event.EXITING 常量定义 exiting 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

Event.FRAME_CONSTRUCTED 常量定义 frameConstructed 事件对象的 type 属性的值。

注意：此事件既不具有“捕获阶段”也不具有“冒泡阶段”，这意味着必须直接将事件侦听器添加到任何潜在的目标，而无论目标是否位于显示列表中。

此事件具有以下属性：

另请参见

Event.FULL_SCREEN 常量定义 fullScreen 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

Event.HTML_BOUNDS_CHANGE 常量定义 htmlBoundsChange 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

Event.HTML_DOM_INITIALIZE 常量定义 htmlDOMInitialize 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

Event.HTML_RENDER 常量定义 htmlRender 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

Event.ID3 常量定义 id3 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

Event.INIT 常量定义 init 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

Event.LOCATION_CHANGE 常量定义 locationChange 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

Event.MOUSE_LEAVE 常量定义 mouseLeave 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

Event.NETWORK_CHANGE 常量定义 networkChange 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

Event.OPEN 常量用于定义 open 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

Event.PASTE 常量定义 paste 事件对象的 type 属性的值。

此事件具有以下属性：

另请参见

Event.REMOVED 常量定义 removed 事件对象的 type 属性值。

removed 事件适用于 ActionScript 3.0 显示列表并且与 JavaScript 代码无关。

此事件具有以下属性：

另请参见

Event.REMOVED_FROM_STAGE 常量定义 removedFromStage 事件对象的 type 属性值。

removedFromStage 事件适用于 ActionScript 3.0 显示列表并且与 JavaScript 代码无关。

此事件具有以下属性：

另请参见

Event.RENDER 常量定义 render 事件对象的 type 属性的值。

注意：此事件既不具有“捕获阶段”也不具有“冒泡阶段”，这意味着必须直接将事件侦听器添加到任何潜在的目标，而无论目标是否位于显示列表中。

此事件具有以下属性：

另请参见

Event.RESIZE 常量定义 resize 事件对象的 type 属性的值。

此事件具有以下属性：

另请参见

Event.SCROLL 常量定义 scroll 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

Event.SELECT 常量定义 select 事件对象的 type 属性的值。

此事件具有以下属性：

另请参见

Event.SELECT_ALL 常量定义 selectAll 事件对象的 type 属性的值。

此事件具有以下属性：

另请参见

Event.SOUND_COMPLETE 常量定义 soundComplete 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

Event.TAB_CHILDREN_CHANGE 常量定义 tabChildrenChange 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

Event.TAB_ENABLED_CHANGE 常量定义 tabEnabledChange 事件对象的 type 属性值。

tabEnabledChange 事件适用于 ActionScript 3.0 显示列表并且与 JavaScript 代码无关。

此事件具有以下属性：

另请参见

Event.TAB_INDEX_CHANGE 常量定义 tabIndexChange 事件对象的 type 属性值。

tabIndexChange 事件适用于 ActionScript 3.0 显示列表并且与 JavaScript 代码无关。

此事件具有以下属性：

另请参见

Event.UNLOAD 常量定义 unload 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

Event.USER_IDLE 常量定义 userIdle 事件对象的 type 属性值。

此事件具有以下属性：

另请参见

Event.USER_PRESENT 常量定义 userPresent 事件对象的 type 属性值。

此事件具有以下属性：

另