Flash ActionScript 3.0 语言和组件参考（Event）
USER_IDLE : String = \ Event
[静态] Event.USER_IDLE 常量定义 userIdle 事件对象的 type 属性值。 USER_PRESENT : String = \
[静态] Event.USER_PRESENT 常量定义 userPresent 事件对象的 type 属性Event
值。
属性详细信息 bubbles 属性
bubbles:Boolean [只读 (read-only)] 语言版本: ActionScript 3.0 运行时版本: AIR 1.0, Flash Player 9 指示事件是否为冒泡事件。 如果事件可以冒泡，则此值为 true；否则为 false。 事件冒泡是为 SWF 内容中的显示对象定义的，它使用 ActionScript 3.0 显示对象模型。bubbles 属性仅在 ActionScript 3.0 代码中有效。
发生事件时，该事件在事件流的三个阶段中移动：捕获阶段，该阶段从显示列表层次结构的顶部流动到目标节点之前的节点；目标阶段，该阶段只包括目标节点；冒泡阶段，该阶段从目标节点的后续节点沿显示列表层次结构向上往回流动。
某些事件（例如 activate 和 unload 事件）没有冒泡阶段。 对于没有冒泡阶段的事件，bubbles 属性的值为 false。
实现
public function get bubbles():Boolean cancelable 属性
cancelable:Boolean [只读 (read-only)] 语言版本: ActionScript 3.0 运行时版本: AIR 1.0, Flash Player 9
指示是否可以阻止与事件相关联的行为。 如果可以取消该行为，则此值为 true；否则为 false。
实现
public function get cancelable():Boolean 另请参见
Event.preventDefault() currentTarget 属性
currentTarget:Object [只读 (read-only)]
第 6 页 共 35 页
Flash ActionScript 3.0 语言和组件参考（Event）
语言版本: ActionScript 3.0 运行时版本: AIR 1.0, Flash Player 9
当前正在使用某个事件侦听器处理 Event 对象的对象。 例如，如果用户单击“确定”按钮，则当前目标可以是包含该按钮的节点，也可以是它的已为该事件注册了事件侦听器的始祖之一。
实现
public function get currentTarget():Object eventPhase 属性
eventPhase:uint [只读 (read-only)] 语言版本: ActionScript 3.0 运行时版本: AIR 1.0, Flash Player 9 事件流中的当前阶段。 此属性可以包含以下数值： 捕获阶段 (EventPhase.CAPTURING_PHASE)。 ? 目标阶段 (EventPhase.AT_TARGET)。 ? 冒泡阶段 (EventPhase.BUBBLING_PHASE)。
?
该事件流是为 SWF 内容中的显示对象定义的，它使用 ActionScript 3.0 显示对象模型。eventPhase 属性仅在 ActionScript 3.0 代码中有效。
实现
public function get eventPhase():uint target 属性
target:Object [只读 (read-only)] 语言版本: ActionScript 3.0 运行时版本: AIR 1.0, Flash Player 9
事件目标。 此属性包含目标节点。 例如，如果用户单击“确定”按钮，则目标节点就是包含该按钮的显示列表节点。
实现
public function get target():Object type 属性
type:String [只读 (read-only)] 语言版本: ActionScript 3.0 运行时版本: AIR 1.0, Flash Player 9
第 7 页 共 35 页
Flash ActionScript 3.0 语言和组件参考（Event）
事件的类型。类型区分大小写。
实现
public function get type():String 构造函数详细信息 Event () 构造函数
public function Event(type:String, bubbles:Boolean = false, cancelable:Boolean = false) 语言版本: ActionScript 3.0 运行时版本: AIR 1.0, Flash Player 9 创建一个作为参数传递给事件侦听器的 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 复制 Event 子类的实例。
返回一个新的 Event 对象，它是 Event 对象的原始实例的副本。 通常您不需要调用 clone()；当您重新调度事件，即调用 dispatchEvent(event)（从正在处理 event 的处理函数）时，EventDispatcher 类会自动调用它。 新的 Event 对象包括原始对象的所有属性。
当您创建自己的自定义 Event 类时，必须覆盖继承的 Event.clone() 方法，以复制自定义类的属性。 如果您未设置在事件子类中添加的所有属性，则当侦听器处理重新调度的事件时，这些属性将不会有正确的值。
在本示例中，PingEvent 是 Event 的子类，因此它可以实现其自己的 clone() 版本。 class PingEvent extends Event { var URL:String;
第 8 页 共 35 页
Flash ActionScript 3.0 语言和组件参考（Event）
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 用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。建议覆盖 toString() 方法，但不是必须覆盖。
class PingEvent extends Event { var URL:String;
public override function toString():String {
return formatToString(\\ } }
此方法用于创建将在 SWF 内容中使用的 ActionScript 3.0 类。 参数
className:String — 自定义 Event 类的名称。 在上面的示例中，className 参数为 PingEvent。
... arguments — Event 类的属性和在自定义 Event 类中添加的属性。在上面的示
例中，...arguments 参数包括 type、bubbles、cancelable、eventPhase 和 URL。 返回
String — 自定义 Event 类的名称和 ...arguments 参数的字符串
值。
isDefaultPrevented () 方法 public function isDefaultPrevented():Boolean 语言版本: ActionScript 3.0 运行时版本: AIR 1.0, Flash Player 9 检查是否已对事件调用 preventDefault() 方法。如果已调用 preventDefault() 方法，则返回 true；否则返回 false。
第 9 页 共 35 页
Flash ActionScript 3.0 语言和组件参考（Event）
返回
Boolean — 如果已调用 preventDefault()，将返回 true；否则将返回 false。 另请参见
flash.events.Event.preventDefault() preventDefault () 方法
public function preventDefault():void 语言版本: ActionScript 3.0 运行时版本: AIR 1.0, Flash Player 9 如果可以取消事件的默认行为，则取消该行为。
许多事件都有默认执行的关联行为。例如，如果用户在文本字段中键入一个字符，则默认行为就是在文本字段中显示该字符。 由于可以取消 TextEvent.TEXT_INPUT 事件的默认行为，因此您可以使用 preventDefault() 方法来防止显示该字符。 例如，在用户单击窗口的关闭框时，默认行为是窗口关闭。由于可以取消 closing 事件的默认行为，因此您可以使用 preventDefault() 方法来防止关闭该窗口。
不可取消行为的一个示例是与 Event.REMOVED 事件关联的默认行为，只要 Flash Player 从显示列表中删除显示对象，就会生成该事件。 由于无法取消默认行为（删除元素），因此 preventDefault() 方法对此默认行为无效。
您可以使用 Event.cancelable 属性来检查是否可以防止与特定事件关联的默认行为。 如果 Event.cancelable 的值为 true，则可以使用 preventDefault() 来取消事件；否则，preventDefault() 无效。 另请参见
flash.events.Event.isDefaultPrevented() Event.cancelable
stopImmediatePropagation () 方法
public function stopImmediatePropagation():void 语言版本: ActionScript 3.0 运行时版本: AIR 1.0, Flash Player 9
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。 此方法会立即生效，并且会影响当前节点中的事件侦听器。 相比之下，在当前节点中的所有事件侦听器都完成处理之前，stopPropagation() 方法不会生效。
注意：此方法不会取消与此事件相关联的行为；有关此功能的信息，请参阅 preventDefault()。
该事件流是为 SWF 内容中的显示对象定义的，它使用 ActionScript 3.0 显示对象模型。
第 10 页 共 35 页