| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
Event 类的属性包含有关事件的基本信息,例如事件的类型或者是否可以取消事件的默认行为。 对于许多事件(如由 Event 类常量表示的事件),此基本信息就足够了。 但其它事件可能需要更详细的信息。 例如,与鼠标单击关联的事件需要包括有关单击事件的位置以及在单击事件期间是否按下了任何键的其它信息。 您可以通过扩展 Event 类(MouseEvent 类执行的操作)将此类其它信息传递给事件侦听器。 Flash® Player API 为需要其它信息的常见事件定义了多个 Event 子类。 与每个 Event 子类关联的事件将在每个类的文档中加以介绍。
Event 类的方法可以在事件侦听器函数中使用以影响事件对象的行为。 某些事件有关联的默认行为。 例如,doubleClick 事件有关联的默认行为,此行为突出显示事件发生时鼠标指针下的词。 通过调用 preventDefault() 方法,您的事件侦听器可以取消此行为。 通过调用 stopPropogation() 或 stopImmediatePropogation() 方法,还可以使当前事件侦听器成为要处理事件的最后一个事件侦听器。
另请参见
| 属性 | 定义方 | ||
|---|---|---|---|
| bubbles : Boolean
[read-only]
指示事件是否为冒泡事件。
| Event | ||
| cancelable : Boolean
[read-only]
指示是否可以阻止与事件相关联的行为。
| Event | ||
![]() | constructor : Object
对类对象或给定对象实例的构造函数的引用。
| Object | |
| currentTarget : Object
[read-only]
当前正在使用某个事件侦听器处理 Event 对象的对象。
| Event | ||
| eventPhase : uint
[read-only]
事件流中的当前阶段。
| Event | ||
![]() | prototype : Object
[static]
对类或函数对象的原型对象的引用。
| Object | |
| target : Object
[read-only]
事件目标。
| Event | ||
| type : String
[read-only]
事件的类型。
| Event | ||
| 方法 | 定义方 | ||
|---|---|---|---|
|
创建一个作为参数传递给事件侦听器的 Event 对象。
| Event | ||
|
复制 Event 子类的实例。
| Event | ||
|
在自定义 Event 类中实现 toString() 方法的实用程序函数。
| Event | ||
![]() |
指示对象是否已经定义了指定的属性。
| Object | |
|
检查是否已对事件调用 preventDefault()。
| Event | ||
![]() |
指示 Object 类的实例是否在指定为参数的对象的原型链中。
| Object | |
|
如果可以取消事件的默认行为,则取消该行为。
| Event | ||
![]() |
指示指定的属性是否存在、是否可枚举。
| Object | |
![]() |
设置循环操作动态属性的可用性。
| Object | |
|
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。
| Event | ||
|
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。
| Event | ||
|
返回一个字符串,其中包含 Event 对象的所有属性。
| Event | ||
![]() |
返回指定对象的原始值。
| Object | |
| 常量 | 定义方 | ||
|---|---|---|---|
| ACTIVATE : String = "activate" [static]
定义 activate 事件对象的 type 属性值。
| Event | ||
| ADDED : String = "added" [static]
定义 added 事件对象的 type 属性值。
| Event | ||
| ADDED_TO_STAGE : String = "addedToStage" [static]
定义 addedToStage 事件对象的 type 属性值。
| Event | ||
| CANCEL : String = "cancel" [static]
定义 cancel 事件对象的 type 属性值。
| Event | ||
| CHANGE : String = "change" [static]
定义 change 事件对象的 type 属性值。
| Event | ||
| CLOSE : String = "close" [static]
定义 close 事件对象的 type 属性值。
| Event | ||
| COMPLETE : String = "complete" [static]
定义 complete 事件对象的 type 属性值。
| Event | ||
| CONNECT : String = "connect" [static]
定义 connect 事件对象的 type 属性值。
| Event | ||
| DEACTIVATE : String = "deactivate" [static]
定义 deactivate 事件对象的 type 属性值。
| Event | ||
| ENTER_FRAME : String = "enterFrame" [static]
定义 enterFrame 事件对象的 type 属性值。
| Event | ||
| FULLSCREEN : String = "fullScreen" [static]
定义 fullScreen 事件对象的 type 属性值。
| Event | ||
| ID3 : String = "id3" [static]
定义 id3 事件对象的 type 属性值。
| Event | ||
| INIT : String = "init" [static]
定义 init 事件对象的 type 属性值。
| Event | ||
| MOUSE_LEAVE : String = "mouseLeave" [static]
定义 mouseLeave 事件对象的 type 属性值。
| Event | ||
| OPEN : String = "open" [static]
定义 open 事件对象的 type 属性值。
| Event | ||
| REMOVED : String = "removed" [static]
定义 removed 事件对象的 type 属性值。
| Event | ||
| REMOVED_FROM_STAGE : String = "removedFromStage" [static]
定义 removedFromStage 事件对象的 type 属性值。
| Event | ||
| RENDER : String = "render" [static]
定义 render 事件对象的 type 属性值。
| Event | ||
| RESIZE : String = "resize" [static]
定义 resize 事件对象的 type 属性值。
| Event | ||
| SCROLL : String = "scroll" [static]
定义 scroll 事件对象的 type 属性值。
| Event | ||
| SELECT : String = "select" [static]
定义 select 事件对象的 type 属性值。
| Event | ||
| SOUND_COMPLETE : String = "soundComplete" [static]
定义 soundComplete 事件对象的 type 属性值。
| Event | ||
| TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [static]
定义 tabChildrenChange 事件对象的 type 属性值。
| Event | ||
| TAB_ENABLED_CHANGE : String = "tabEnabledChange" [static]
定义 tabEnabledChange 事件对象的 type 属性值。
| Event | ||
| TAB_INDEX_CHANGE : String = "tabIndexChange" [static]
定义 tabIndexChange 事件对象的 type 属性值。
| Event | ||
| UNLOAD : String = "unload" [static]
定义 unload 事件对象的 type 属性值。
| Event | ||
| bubbles | 属性 |
bubbles:Boolean [read-only]
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
指示事件是否为冒泡事件。 如果事件可以冒泡,则此值为 true;否则为 false。
发生事件时,该事件在事件流的三个阶段中移动:捕获阶段,该阶段从显示列表层次结构的顶部流动到目标节点之前的节点;目标阶段,该阶段只包括目标节点;冒泡阶段,该阶段从目标节点的后续节点沿显示列表层次结构向上往回流动。
某些事件(例如 activate 和 unload 事件)没有冒泡阶段。 对于没有冒泡阶段的事件,bubbles 属性的值为 false。
public function get bubbles():Boolean
另请参见
| cancelable | 属性 |
cancelable:Boolean [read-only]
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
指示是否可以阻止与事件相关联的行为。 如果可以取消该行为,则此值为 true;否则为 false。
public function get cancelable():Boolean
另请参见
| currentTarget | 属性 |
currentTarget:Object [read-only]
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
当前正在使用某个事件侦听器处理 Event 对象的对象。 例如,如果用户单击“确定”按钮,则当前目标可以是包含该按钮的节点,也可以是它的已为该事件注册了事件侦听器的始祖之一。
public function get currentTarget():Object
另请参见
| eventPhase | 属性 |
eventPhase:uint [read-only]
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
事件流中的当前阶段。 此属性可以包含以下数值:
EventPhase.CAPTURING_PHASE)。EventPhase.AT_TARGET)。EventPhase.BUBBLING_PHASE)。 public function get eventPhase():uint
另请参见
| target | 属性 |
target:Object [read-only]
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
事件目标。 此属性包含目标节点。 例如,如果用户单击“确定”按钮,则目标节点就是包含该按钮的显示列表节点。
public function get target():Object
另请参见
| type | 属性 |
type:String [read-only]
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
事件的类型。类型区分大小写。
public function get type():String
另请参见
| Event | () | 构造函数 |
public function Event(type:String, bubbles:Boolean = false, cancelable:Boolean = false)
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | 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 |
| Player 版本 : | 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; 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 |
| Player 版本 : | Flash Player 9 |
在自定义 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 参数的字符串值。
|
| isDefaultPrevented | () | 方法 |
public function isDefaultPrevented():Boolean
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
检查是否已对事件调用 preventDefault()。 如果已调用 preventDefault(),将返回 true;否则将返回 false。
Boolean — 如果已调用 preventDefault(),将返回 true;否则将返回 false。
|
另请参见
| preventDefault | () | 方法 |
public function preventDefault():void
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
如果可以取消事件的默认行为,则取消该行为。
默认情况下,许多事件都有 Flash Player 执行的关联行为。 例如,如果用户在文本字段中键入一个字符,则默认行为就是在文本字段中显示该字符。 由于可以取消 TextEvent.TEXT_INPUT 事件的默认行为,因此您可以使用 preventDefault() 方法来防止显示该字符。
不可取消行为的一个示例是与 Event.REMOVED 事件关联的默认行为,只要 Flash Player 从显示列表中删除显示对象,就会生成该事件。 由于无法取消默认行为(删除元素),因此 preventDefault() 方法对此默认行为无效。
您可以使用 Event.cancelable 属性来检查是否可以防止与特定事件关联的默认行为。 如果 Event.cancelable 的值为 true,则可以使用 preventDefault() 来取消事件;否则,preventDefault() 无效。
另请参见
| stopImmediatePropagation | () | 方法 |
public function stopImmediatePropagation():void
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。 此方法会立即生效,并且会影响当前节点中的事件侦听器。 相比之下,在当前节点中的所有事件侦听器都完成处理之前,stopPropagation() 方法不会生效。
注意:此方法不会取消与此事件相关联的行为;有关此功能的信息,请参阅 preventDefault()。
另请参见
| stopPropagation | () | 方法 |
public function stopPropagation():void
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。 此方法不会影响当前节点 (currentTarget) 中的任何事件侦听器。 相比之下,stopImmediatePropagation() 方法可以防止对当前节点中和后续节点中的事件侦听器进行处理。 对此方法的其它调用没有任何效果。 可以在事件流的任何阶段中调用此方法。
注意:此方法不会取消与此事件相关联的行为;有关此功能的信息,请参阅 preventDefault()。
另请参见
| toString | () | 方法 |
public function toString():String
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
返回一个字符串,其中包含 Event 对象的所有属性。 字符串的格式如下:
[Event type=value bubbles=value cancelable=value]
String — 一个字符串,其中包含 Event 对象的所有属性。
|
另请参见
| ACTIVATE | 常量 |
public static const ACTIVATE:String = "activate"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 activate 事件对象的 type 属性值。
注意:无论目标是否出现在显示列表中,此事件都不会通过“捕获阶段”,而是被直接调度给此目标。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 具有为 ACTIVATE 事件注册的侦听器的任何 DisplayObject 实例。 |
另请参见
| ADDED | 常量 |
public static const ADDED:String = "added"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 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 |
| Player 版本 : | Flash Player 9.0.28.0 |
定义 addedToStage 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | DisplayObject 实例将添加到舞台的显示列表中,可直接添加它,也可以添加包含 DisplayObject 实例的子树。 如果 DisplayObject 实例将被直接添加,会在此事件之前发生 added 事件。 |
另请参见
| CANCEL | 常量 |
public static const CANCEL:String = "cancel"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 cancel 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 对已取消其操作的对象的引用。 |
另请参见
| CHANGE | 常量 |
public static const CHANGE:String = "change"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 change 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | true |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 已修改其值的对象。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。 |
另请参见
| CLOSE | 常量 |
public static const CLOSE:String = "close"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 close 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 已关闭其连接的对象。 |
另请参见
| COMPLETE | 常量 |
public static const COMPLETE:String = "complete"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 complete 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 已完成加载的网络对象。 |
另请参见
| CONNECT | 常量 |
public static const CONNECT:String = "connect"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 connect 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 已建立网络连接的 Socket 或 XMLSocket 对象。 |
另请参见
| DEACTIVATE | 常量 |
public static const DEACTIVATE:String = "deactivate"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 deactivate 事件对象的 type 属性值。
注意:无论目标是否出现在显示列表中,此事件都不会通过“捕获阶段”,而是被直接调度给此目标。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 具有为 DEACTIVATE 事件注册的侦听器的任何 DisplayObject 实例。 |
另请参见
| ENTER_FRAME | 常量 |
public static const ENTER_FRAME:String = "enterFrame"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 enterFrame 事件对象的 type 属性值。
注意:无论目标是否出现在显示列表中,此事件都不会通过“捕获阶段”,而是被直接调度给此目标。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 具有为 ENTER_FRAME 事件注册的侦听器的任何 DisplayObject 实例。 |
另请参见
| FULLSCREEN | 常量 |
public static const FULLSCREEN:String = "fullScreen"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 fullScreen 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | Stage 对象。 |
另请参见
| ID3 | 常量 |
public static const ID3:String = "id3"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 id3 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 加载 MP3 的 Sound 对象,ID3 数据现在可用于此对象。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。 |
另请参见
| INIT | 常量 |
public static const INIT:String = "init"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 init 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 与所加载的 SWF 文件相关联的 LoaderInfo 对象。 |
另请参见
| MOUSE_LEAVE | 常量 |
public static const MOUSE_LEAVE:String = "mouseLeave"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 mouseLeave 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | Stage 对象。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。 |
另请参见
| OPEN | 常量 |
public static const OPEN:String = "open"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 open 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 已打开连接的网络对象。 |
另请参见
| REMOVED | 常量 |
public static const REMOVED:String = "removed"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 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 |
| Player 版本 : | Flash Player 9.0.28.0 |
定义 removedFromStage 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | DisplayObject 实例将从舞台的显示列表中删除,可直接删除它,也可以删除包含 DisplayObject 实例的子树。 如果 DisplayObject 实例将被直接删除,会在此事件之前发生 removed 事件。 |
另请参见
| RENDER | 常量 |
public static const RENDER:String = "render"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 render 事件对象的 type 属性值。
注意:无论目标是否出现在显示列表中,此事件都不会通过“捕获阶段”,而是被直接调度给此目标。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false;不能取消默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 具有为 RENDER 事件注册的侦听器的任何 DisplayObject 实例。 |
另请参见
| RESIZE | 常量 |
public static const RESIZE:String = "resize"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 resize 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | Stage 对象。 |
另请参见
| SCROLL | 常量 |
public static const SCROLL:String = "scroll"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 scroll 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 已滚动的 TextField 对象。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。 |
另请参见
| SELECT | 常量 |
public static const SELECT:String = "select"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 select 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | FileReference 对象,已在其中选定了一个项目。 |
另请参见
| SOUND_COMPLETE | 常量 |
public static const SOUND_COMPLETE:String = "soundComplete"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 soundComplete 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 已结束声音播放的 Sound 对象。 |
另请参见
| TAB_CHILDREN_CHANGE | 常量 |
public static const TAB_CHILDREN_CHANGE:String = "tabChildrenChange"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 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 |
| Player 版本 : | Flash Player 9 |
定义 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 |
| Player 版本 : | Flash Player 9 |
定义 tabIndexChange 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | true |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 其 tabIndex 已更改的对象。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。 |
另请参见
| UNLOAD | 常量 |
public static const UNLOAD:String = "unload"
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
定义 unload 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | LoaderInfo 对象与将被卸载或替换的 SWF 文件相关联。 |
另请参见
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);
}
}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);
}
}
}
当前页: http://livedocs.adobe.com/flash/9.0_cn/ActionScriptLangRefV3/flash/events/Event.html