flash.events
public class Event
继承Event Inheritance Object
子类 ActivityEvent, CaptionChangeEvent, CaptionTargetEvent, ColorPickerEvent, ComponentEvent, ContextMenuEvent, DataChangeEvent, FocusEvent, HTTPStatusEvent, KeyboardEvent, LayoutEvent, ListEvent, MetadataEvent, MotionEvent, MouseEvent, NetStatusEvent, ProgressEvent, ScrollEvent, SliderEvent, SoundEvent, StatusEvent, SyncEvent, TextEvent, TimerEvent, TweenEvent, VideoEvent

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

Event 类作为创建 Event 对象的基类,当发生事件时,Event 对象将作为参数传递给事件侦听器。

Event 类的属性包含有关事件的基本信息,例如事件的类型或者是否可以取消事件的默认行为。 对于许多事件(如由 Event 类常量表示的事件),此基本信息就足够了。 但其它事件可能需要更详细的信息。 例如,与鼠标单击关联的事件需要包括有关单击事件的位置以及在单击事件期间是否按下了任何键的其它信息。 您可以通过扩展 Event 类(MouseEvent 类执行的操作)将此类其它信息传递给事件侦听器。 Flash® Player API 为需要其它信息的常见事件定义了多个 Event 子类。 与每个 Event 子类关联的事件将在每个类的文档中加以介绍。

Event 类的方法可以在事件侦听器函数中使用以影响事件对象的行为。 某些事件有关联的默认行为。 例如,doubleClick 事件有关联的默认行为,此行为突出显示事件发生时鼠标指针下的词。 通过调用 preventDefault() 方法,您的事件侦听器可以取消此行为。 通过调用 stopPropogation()stopImmediatePropogation() 方法,还可以使当前事件侦听器成为要处理事件的最后一个事件侦听器。

查看示例

另请参见

flash.events.EventDispatcher
事件对象



公共 属性
 属性定义方
  bubbles : Boolean
[read-only] 指示事件是否为冒泡事件。
Event
  cancelable : Boolean
[read-only] 指示是否可以阻止与事件相关联的行为。
Event
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  currentTarget : Object
[read-only] 当前正在使用某个事件侦听器处理 Event 对象的对象。
Event
  eventPhase : uint
[read-only] 事件流中的当前阶段。
Event
 Inheritedprototype : Object
[static] 对类或函数对象的原型对象的引用。
Object
  target : Object
[read-only] 事件目标。
Event
  type : String
[read-only] 事件的类型。
Event
公共 方法
 方法定义方
  
Event(type:String, bubbles:Boolean = false, cancelable:Boolean = false)
创建一个作为参数传递给事件侦听器的 Event 对象。
Event
  
复制 Event 子类的实例。
Event
  
formatToString(className:String, ... arguments):String
在自定义 Event 类中实现 toString() 方法的实用程序函数。
Event
 Inherited
指示对象是否已经定义了指定的属性。
Object
  
检查是否已对事件调用 preventDefault()。
Event
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
  
如果可以取消事件的默认行为,则取消该行为。
Event
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
设置循环操作动态属性的可用性。
Object
  
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。
Event
  
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。
Event
  
返回一个字符串,其中包含 Event 对象的所有属性。
Event
 Inherited
返回指定对象的原始值。
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

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

某些事件(例如 activateunload 事件)没有冒泡阶段。 对于没有冒泡阶段的事件,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

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


实现
    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() 方法,以复制自定义类的属性。 如果您未设置在事件子类中添加的所有属性,则当侦听器处理重新调度的事件时,这些属性将不会有正确的值。

在本示例中,PingEventEvent 的子类,因此它可以实现其自己的 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 参数包括 typebubblescancelableeventPhaseURL

返回
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 属性值。

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

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target具有为 ACTIVATE 事件注册的侦听器的任何 DisplayObject 实例。

另请参见

ADDED常量 
public static const ADDED:String = "added"

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

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

此事件具有以下属性:

属性
bubblestrue
cancelablefalse;没有要取消的默认行为。
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 属性值。

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
targetDisplayObject 实例将添加到舞台的显示列表中,可直接添加它,也可以添加包含 DisplayObject 实例的子树。 如果 DisplayObject 实例将被直接添加,会在此事件之前发生 added 事件。

另请参见

CANCEL常量 
public static const CANCEL:String = "cancel"

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

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

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target对已取消其操作的对象的引用。

另请参见

CHANGE常量 
public static const CHANGE:String = "change"

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

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

此事件具有以下属性:

属性
bubblestrue
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target已修改其值的对象。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见

CLOSE常量 
public static const CLOSE:String = "close"

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

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

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target已关闭其连接的对象。

另请参见

COMPLETE常量 
public static const COMPLETE:String = "complete"

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

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

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target已完成加载的网络对象。

另请参见

CONNECT常量 
public static const CONNECT:String = "connect"

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

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

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target已建立网络连接的 Socket 或 XMLSocket 对象。

另请参见

DEACTIVATE常量 
public static const DEACTIVATE:String = "deactivate"

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

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

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

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target具有为 DEACTIVATE 事件注册的侦听器的任何 DisplayObject 实例。

另请参见

ENTER_FRAME常量 
public static const ENTER_FRAME:String = "enterFrame"

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

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

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

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target具有为 ENTER_FRAME 事件注册的侦听器的任何 DisplayObject 实例。

另请参见

FULLSCREEN常量 
public static const FULLSCREEN:String = "fullScreen"

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

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

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
targetStage 对象。

另请参见

ID3常量 
public static const ID3:String = "id3"

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

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

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target加载 MP3 的 Sound 对象,ID3 数据现在可用于此对象。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见

INIT常量 
public static const INIT:String = "init"

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

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

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target与所加载的 SWF 文件相关联的 LoaderInfo 对象。

另请参见

MOUSE_LEAVE常量 
public static const MOUSE_LEAVE:String = "mouseLeave"

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

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

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
targetStage 对象。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见

OPEN常量 
public static const OPEN:String = "open"

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

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

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target已打开连接的网络对象。

另请参见

REMOVED常量 
public static const REMOVED:String = "removed"

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

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

此事件具有以下属性:

属性
bubblestrue
cancelablefalse;没有要取消的默认行为。
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 属性值。

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
targetDisplayObject 实例将从舞台的显示列表中删除,可直接删除它,也可以删除包含 DisplayObject 实例的子树。 如果 DisplayObject 实例将被直接删除,会在此事件之前发生 removed 事件。

另请参见

RENDER常量 
public static const RENDER:String = "render"

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

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

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

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;不能取消默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target具有为 RENDER 事件注册的侦听器的任何 DisplayObject 实例。

另请参见

RESIZE常量 
public static const RESIZE:String = "resize"

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

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

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
targetStage 对象。

另请参见

SCROLL常量 
public static const SCROLL:String = "scroll"

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

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

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target已滚动的 TextField 对象。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见

SELECT常量 
public static const SELECT:String = "select"

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

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

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
targetFileReference 对象,已在其中选定了一个项目。

另请参见

SOUND_COMPLETE常量 
public static const SOUND_COMPLETE:String = "soundComplete"

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

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

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target已结束声音播放的 Sound 对象。

另请参见

TAB_CHILDREN_CHANGE常量 
public static const TAB_CHILDREN_CHANGE:String = "tabChildrenChange"

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

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

此事件具有以下属性:

属性
bubblestrue
cancelablefalse;没有要取消的默认行为。
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 属性值。

此事件具有以下属性:

属性
bubblestrue
cancelablefalse;没有要取消的默认行为。
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 属性值。

此事件具有以下属性:

属性
bubblestrue
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target其 tabIndex 已更改的对象。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见

UNLOAD常量 
public static const UNLOAD:String = "unload"

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

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

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
targetLoaderInfo 对象与将被卸载或替换的 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);
    }
}

以下示例创建 ADDEDADDED_TO_STAGE 事件以及 REMOVEDREMOVED_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