flash.events
public class MouseEvent
继承MouseEvent Inheritance Event Inheritance Object

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

每次发生鼠标事件时,Flash® Player 都会将 MouseEvent 对象调度到事件流中。 鼠标事件通常由使用指针的用户输入设备(如鼠标或轨迹球)生成。

当包含嵌套节点时,鼠标事件指向在显示列表中可见的最深的可能嵌套节点。 此节点称为目标节点。 若要让目标节点的始祖接收鼠标事件的通知,请使用始祖节点上其 type 参数设置为您要检测的特定鼠标事件的 EventDispatcher.addEventListener()

查看示例




公共 属性
 属性定义方
  altKey : Boolean
保留以供将来使用。
MouseEvent
 Inheritedbubbles : Boolean
[read-only] 指示事件是否为冒泡事件。
Event
  buttonDown : Boolean
指示鼠标主按键是已按下 (true) 还是未按下 (false)。
MouseEvent
 Inheritedcancelable : Boolean
[read-only] 指示是否可以阻止与事件相关联的行为。
Event
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  ctrlKey : Boolean
指示 Ctrl 键是处于活动状态 (true) 还是非活动状态 (false)。
MouseEvent
 InheritedcurrentTarget : Object
[read-only] 当前正在使用某个事件侦听器处理 Event 对象的对象。
Event
  delta : int
指示用户将鼠标滚轮每滚动一个单位应滚动多少行。
MouseEvent
 InheritedeventPhase : uint
[read-only] 事件流中的当前阶段。
Event
  localX : Number
事件发生点的相对于包含 Sprite 的水平坐标。
MouseEvent
  localY : Number
事件发生点的相对于包含 Sprite 的垂直坐标。
MouseEvent
 Inheritedprototype : Object
[static] 对类或函数对象的原型对象的引用。
Object
  relatedObject : InteractiveObject
对与事件相关的显示列表对象的引用。
MouseEvent
  shiftKey : Boolean
指示 Shift 键是处于活动状态 (true) 还是非活动状态 (false)。
MouseEvent
  stageX : Number
[read-only] 事件发生点在全局舞台坐标中的水平坐标。
MouseEvent
  stageY : Number
[read-only] 事件发生点在全局舞台坐标中的垂直坐标。
MouseEvent
 Inheritedtarget : Object
[read-only] 事件目标。
Event
 Inheritedtype : String
[read-only] 事件的类型。
Event
公共 方法
 方法定义方
  
MouseEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, localX:Number, localY:Number, relatedObject:InteractiveObject = null, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, buttonDown:Boolean = false, delta:int = 0)
创建一个 Event 对象,其中包含有关鼠标事件的信息。
MouseEvent
  
创建 MouseEvent 对象的副本,并设置每个属性的值以匹配原始属性值。
MouseEvent
 Inherited
formatToString(className:String, ... arguments):String
在自定义 Event 类中实现 toString() 方法的实用程序函数。
Event
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
检查是否已对事件调用 preventDefault()。
Event
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
如果可以取消事件的默认行为,则取消该行为。
Event
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。
Event
 Inherited
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。
Event
  
返回一个字符串,其中包含 MouseEvent 对象的所有属性。
MouseEvent
  
如果已修改显示列表,则此事件处理完成后将指示 Flash Player 呈现结果。
MouseEvent
 Inherited
返回指定对象的原始值。
Object
公共 常量
 常量定义方
 InheritedACTIVATE : String = "activate"
[static] 定义 activate 事件对象的 type 属性值。
Event
 InheritedADDED : String = "added"
[static] 定义 added 事件对象的 type 属性值。
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[static] 定义 addedToStage 事件对象的 type 属性值。
Event
 InheritedCANCEL : String = "cancel"
[static] 定义 cancel 事件对象的 type 属性值。
Event
 InheritedCHANGE : String = "change"
[static] 定义 change 事件对象的 type 属性值。
Event
  CLICK : String = "click"
[static] 定义 click 事件对象的 type 属性值。
MouseEvent
 InheritedCLOSE : String = "close"
[static] 定义 close 事件对象的 type 属性值。
Event
 InheritedCOMPLETE : String = "complete"
[static] 定义 complete 事件对象的 type 属性值。
Event
 InheritedCONNECT : String = "connect"
[static] 定义 connect 事件对象的 type 属性值。
Event
 InheritedDEACTIVATE : String = "deactivate"
[static] 定义 deactivate 事件对象的 type 属性值。
Event
  DOUBLE_CLICK : String = "doubleClick"
[static] 定义 doubleClick 事件对象的 type 属性值。
MouseEvent
 InheritedENTER_FRAME : String = "enterFrame"
[static] 定义 enterFrame 事件对象的 type 属性值。
Event
 InheritedFULLSCREEN : String = "fullScreen"
[static] 定义 fullScreen 事件对象的 type 属性值。
Event
 InheritedID3 : String = "id3"
[static] 定义 id3 事件对象的 type 属性值。
Event
 InheritedINIT : String = "init"
[static] 定义 init 事件对象的 type 属性值。
Event
  MOUSE_DOWN : String = "mouseDown"
[static] 定义 mouseDown 事件对象的 type 属性值。
MouseEvent
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[static] 定义 mouseLeave 事件对象的 type 属性值。
Event
  MOUSE_MOVE : String = "mouseMove"
[static] 定义 mouseMove 事件对象的 type 属性值。
MouseEvent
  MOUSE_OUT : String = "mouseOut"
[static] 定义 mouseOut 事件对象的 type 属性值。
MouseEvent
  MOUSE_OVER : String = "mouseOver"
[static] 定义 mouseOver 事件对象的 type 属性值。
MouseEvent
  MOUSE_UP : String = "mouseUp"
[static] 定义 mouseUp 事件对象的 type 属性值。
MouseEvent
  MOUSE_WHEEL : String = "mouseWheel"
[static] 定义 mouseWheel 事件对象的 type 属性值。
MouseEvent
 InheritedOPEN : String = "open"
[static] 定义 open 事件对象的 type 属性值。
Event
 InheritedREMOVED : String = "removed"
[static] 定义 removed 事件对象的 type 属性值。
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[static] 定义 removedFromStage 事件对象的 type 属性值。
Event
 InheritedRENDER : String = "render"
[static] 定义 render 事件对象的 type 属性值。
Event
 InheritedRESIZE : String = "resize"
[static] 定义 resize 事件对象的 type 属性值。
Event
  ROLL_OUT : String = "rollOut"
[static] 定义 rollOut 事件对象的 type 属性值。
MouseEvent
  ROLL_OVER : String = "rollOver"
[static] 定义 rollOver 事件对象的 type 属性值。
MouseEvent
 InheritedSCROLL : String = "scroll"
[static] 定义 scroll 事件对象的 type 属性值。
Event
 InheritedSELECT : String = "select"
[static] 定义 select 事件对象的 type 属性值。
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[static] 定义 soundComplete 事件对象的 type 属性值。
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[static] 定义 tabChildrenChange 事件对象的 type 属性值。
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[static] 定义 tabEnabledChange 事件对象的 type 属性值。
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[static] 定义 tabIndexChange 事件对象的 type 属性值。
Event
 InheritedUNLOAD : String = "unload"
[static] 定义 unload 事件对象的 type 属性值。
Event
属性详细信息
altKey属性
altKey:Boolean  [read-write]

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

保留以供将来使用。


实现
    public function get altKey():Boolean
    public function set altKey(value:Boolean):void
buttonDown属性 
buttonDown:Boolean  [read-write]

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

指示鼠标主按键是已按下 (true) 还是未按下 (false)。


实现
    public function get buttonDown():Boolean
    public function set buttonDown(value:Boolean):void
ctrlKey属性 
ctrlKey:Boolean  [read-write]

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

指示 Ctrl 键是处于活动状态 (true) 还是非活动状态 (false)。 在 Macintosh 计算机上,您必须使用此属性来表示 Command 键。


实现
    public function get ctrlKey():Boolean
    public function set ctrlKey(value:Boolean):void
delta属性 
delta:int  [read-write]

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

指示用户将鼠标滚轮每滚动一个单位应滚动多少行。 正 delta 值指示向上滚动;负值指示向下滚动。 通常所设的值为 1 到 3;值越大,滚动得越快。 此设置取决于设备和操作系统,并且通常可由用户配置。 此属性仅应用于 MouseEvent.mouseWheel 事件。


实现
    public function get delta():int
    public function set delta(value:int):void
localX属性 
localX:Number  [read-write]

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

事件发生点的相对于包含 Sprite 的水平坐标。


实现
    public function get localX():Number
    public function set localX(value:Number):void
localY属性 
localY:Number  [read-write]

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

事件发生点的相对于包含 Sprite 的垂直坐标。


实现
    public function get localY():Number
    public function set localY(value:Number):void
relatedObject属性 
relatedObject:InteractiveObject  [read-write]

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

对与事件相关的显示列表对象的引用。 例如,发生 mouseOut 事件时,relatedObject 表示指针设备当前所指向的显示列表对象。 此属性仅应用于 mouseOutmouseOver 事件。


实现
    public function get relatedObject():InteractiveObject
    public function set relatedObject(value:InteractiveObject):void
shiftKey属性 
shiftKey:Boolean  [read-write]

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

指示 Shift 键是处于活动状态 (true) 还是非活动状态 (false)。


实现
    public function get shiftKey():Boolean
    public function set shiftKey(value:Boolean):void
stageX属性 
stageX:Number  [read-only]

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

事件发生点在全局舞台坐标中的水平坐标。 当设置 localX 属性时会计算此属性。


实现
    public function get stageX():Number
stageY属性 
stageY:Number  [read-only]

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

事件发生点在全局舞台坐标中的垂直坐标。 当设置 localY 属性时会计算此属性。


实现
    public function get stageY():Number
构造函数详细信息
MouseEvent()构造函数
public function MouseEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, localX:Number, localY:Number, relatedObject:InteractiveObject = null, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, buttonDown:Boolean = false, delta:int = 0)

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

创建一个 Event 对象,其中包含有关鼠标事件的信息。 将 Event 对象作为参数传递给事件侦听器。

参数
type:String — 事件的类型。可能的值为:MouseEvent.CLICKMouseEvent.DOUBLE_CLICKMouseEvent.MOUSE_DOWNMouseEvent.MOUSE_MOVEMouseEvent.MOUSE_OUTMouseEvent.MOUSE_OVERMouseEvent.MOUSE_UPMouseEvent.MOUSE_WHEELMouseEvent.ROLL_OUTMouseEvent.ROLL_OVER
 
bubbles:Boolean (default = true) — 确定 Event 对象是否参与事件流的冒泡阶段。
 
cancelable:Boolean (default = false) — 确定是否可以取消 Event 对象。
 
localX:Number — 事件发生点的相对于包含 Sprite 的水平坐标。
 
localY:Number — 事件发生点的相对于包含 Sprite 的垂直坐标。
 
relatedObject:InteractiveObject (default = null) — 受事件影响的补充 InteractiveObject 实例。 例如,发生 mouseOut 事件时,relatedObject 表示指针设备当前所指向的显示列表对象。
 
ctrlKey:Boolean (default = false) — 指示是否已激活 Ctrl 键。
 
altKey:Boolean (default = false) — 保留以供将来使用。
 
shiftKey:Boolean (default = false) — 指示是否已激活 Shift 键。
 
buttonDown:Boolean (default = false) — 指示是否按下了鼠标主按键。
 
delta:int (default = 0) — 指示用户将鼠标滚轮每滚动一个单位应滚动多少行。 正 delta 值指示向上滚动;负值指示向下滚动。 通常所设的值为 1 到 3;值越大,滚动得越快。 此参数仅用于 MouseEvent.mouseWheel 事件。
方法详细信息
clone()方法
public override function clone():Event

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

创建 MouseEvent 对象的副本,并设置每个属性的值以匹配原始属性值。

返回
Event — 其属性值与原始属性值匹配的新的 MouseEvent 对象。
toString()方法 
public override function toString():String

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

返回一个字符串,其中包含 MouseEvent 对象的所有属性。 字符串的格式如下:

[MouseEvent type=value bubbles=value cancelable=value ... delta=value]

返回
String — 一个字符串,其中包含 MouseEvent 对象的所有属性。
updateAfterEvent()方法 
public function updateAfterEvent():void

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

如果已修改显示列表,则此事件处理完成后将指示 Flash Player 呈现结果。

常量详细信息
CLICK常量
public static const CLICK:String = "click"

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

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

此事件具有以下属性:

属性
bubblestrue
buttonDown如果按下鼠标主按键,则为 true;否则为 false
cancelablefalse;没有要取消的默认行为。
ctrlKey如果 Ctrl 键处于活动状态,则为 true;如果处于非活动状态,则为 false
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
localX事件发生点的相对于包含 Sprite 的水平坐标。
localY事件发生点的相对于包含 Sprite 的垂直坐标。
shiftKey如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
stageX事件发生点在全局舞台坐标中的水平坐标。
stageY事件发生点在全局舞台坐标中的垂直坐标。
target指针设备下的 InteractiveObject 实例。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见

DOUBLE_CLICK常量 
public static const DOUBLE_CLICK:String = "doubleClick"

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

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

此事件具有以下属性:

属性
bubblestrue
buttonDown如果按下鼠标主按键,则为 true;否则为 false
cancelablefalse;没有要取消的默认行为。
ctrlKey如果 Ctrl 键处于活动状态,则为 true;如果处于非活动状态,则为 false
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
localX事件发生点的相对于包含 Sprite 的水平坐标。
localY事件发生点的相对于包含 Sprite 的垂直坐标。
shiftKey如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
stageX事件发生点在全局舞台坐标中的水平坐标。
stageY事件发生点在全局舞台坐标中的垂直坐标。
target指针设备下的 InteractiveObject 实例。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见

MOUSE_DOWN常量 
public static const MOUSE_DOWN:String = "mouseDown"

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

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

此事件具有以下属性:

属性
bubblestrue
buttonDown如果按下鼠标主按键,则为 true;否则为 false
cancelablefalse;不能取消默认行为。
ctrlKey如果 Ctrl 键处于活动状态,则为 true;如果处于非活动状态,则为 false
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
localX事件发生点的相对于包含 Sprite 的水平坐标。
localY事件发生点的相对于包含 Sprite 的垂直坐标。
shiftKey如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
stageX事件发生点在全局舞台坐标中的水平坐标。
stageY事件发生点在全局舞台坐标中的垂直坐标。
target指针设备下的 InteractiveObject 实例。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见

MOUSE_MOVE常量 
public static const MOUSE_MOVE:String = "mouseMove"

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

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

此事件具有以下属性:

属性
bubblestrue
buttonDown如果按下鼠标主按键,则为 true;否则为 false
cancelablefalse;不能取消默认行为。
ctrlKey如果 Ctrl 键处于活动状态,则为 true;如果处于非活动状态,则为 false
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
localX事件发生点的相对于包含 Sprite 的水平坐标。
localY事件发生点的相对于包含 Sprite 的垂直坐标。
shiftKey如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
stageX事件发生点在全局舞台坐标中的水平坐标。
stageY事件发生点在全局舞台坐标中的垂直坐标。
target指针设备下的 InteractiveObject 实例。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见

MOUSE_OUT常量 
public static const MOUSE_OUT:String = "mouseOut"

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

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

此事件具有以下属性:

属性
bubblestrue
buttonDown如果按下鼠标主按键,则为 true;否则为 false
cancelablefalse;不能取消默认行为。
ctrlKey如果 Ctrl 键处于活动状态,则为 true;如果处于非活动状态,则为 false
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
relatedObject指针设备现在指向的显示列表对象。
localX事件发生点的相对于包含 Sprite 的水平坐标。
localY事件发生点的相对于包含 Sprite 的垂直坐标。
shiftKey如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
stageX事件发生点在全局舞台坐标中的水平坐标。
stageY事件发生点在全局舞台坐标中的垂直坐标。
target指针设备下的 InteractiveObject 实例。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见

MOUSE_OVER常量 
public static const MOUSE_OVER:String = "mouseOver"

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

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

此事件具有以下属性:

属性
bubblestrue
buttonDown如果按下鼠标主按键,则为 true;否则为 false
cancelablefalse;不能取消默认行为。
ctrlKey如果 Ctrl 键处于活动状态,则为 true;如果处于非活动状态,则为 false
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
relatedObject指针设备指向的显示列表对象。
localX事件发生点的相对于包含 Sprite 的水平坐标。
localY事件发生点的相对于包含 Sprite 的垂直坐标。
shiftKey如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
stageX事件发生点在全局舞台坐标中的水平坐标。
stageY事件发生点在全局舞台坐标中的垂直坐标。
target指针设备下的 InteractiveObject 实例。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见

MOUSE_UP常量 
public static const MOUSE_UP:String = "mouseUp"

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

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

此事件具有以下属性:

属性
bubblestrue
buttonDown如果按下鼠标主按键,则为 true;否则为 false
cancelablefalse;不能取消默认行为。
ctrlKey如果 Ctrl 键处于活动状态,则为 true;如果处于非活动状态,则为 false
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
localX事件发生点的相对于包含 Sprite 的水平坐标。
localY事件发生点的相对于包含 Sprite 的垂直坐标。
shiftKey如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
stageX事件发生点在全局舞台坐标中的水平坐标。
stageY事件发生点在全局舞台坐标中的垂直坐标。
target指针设备下的 InteractiveObject 实例。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见

MOUSE_WHEEL常量 
public static const MOUSE_WHEEL:String = "mouseWheel"

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

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

此事件具有以下属性:

属性
bubblestrue
buttonDown如果按下鼠标主按键,则为 true;否则为 false
cancelablefalse;不能取消默认行为。
ctrlKey如果 Ctrl 键处于活动状态,则为 true;如果处于非活动状态,则为 false
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
delta鼠标滚轮上的每个刻度表示的行数。
localX事件发生点的相对于包含 Sprite 的水平坐标。
localY事件发生点的相对于包含 Sprite 的垂直坐标。
shiftKey如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
stageX事件发生点在全局舞台坐标中的水平坐标。
stageY事件发生点在全局舞台坐标中的垂直坐标。
target指针设备下的 InteractiveObject 实例。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见

ROLL_OUT常量 
public static const ROLL_OUT:String = "rollOut"

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

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

此事件具有以下属性:

属性
bubblesfalse
buttonDown如果按下鼠标主按键,则为 true;否则为 false
cancelablefalse;没有要取消的默认行为。
ctrlKey如果 Ctrl 键处于活动状态,则为 true;如果处于非活动状态,则为 false
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
relatedObject指针设备现在指向的显示列表对象。
localX事件发生点的相对于包含 Sprite 的水平坐标。
localY事件发生点的相对于包含 Sprite 的垂直坐标。
shiftKey如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
stageX事件发生点在全局舞台坐标中的水平坐标。
stageY事件发生点在全局舞台坐标中的垂直坐标。
target指针设备下的 InteractiveObject 实例。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见

ROLL_OVER常量 
public static const ROLL_OVER:String = "rollOver"

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

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

此事件具有以下属性:

属性
bubblesfalse
buttonDown如果按下鼠标主按键,则为 true;否则为 false
cancelablefalse;没有要取消的默认行为。
ctrlKey如果 Ctrl 键处于活动状态,则为 true;如果处于非活动状态,则为 false
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
relatedObject指针设备指向的显示列表对象。
localX事件发生点的相对于包含 Sprite 的水平坐标。
localY事件发生点的相对于包含 Sprite 的垂直坐标。
shiftKey如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
stageX事件发生点在全局舞台坐标中的水平坐标。
stageY事件发生点在全局舞台坐标中的垂直坐标。
target指针设备下的 InteractiveObject 实例。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见

示例 如何使用示例

以下示例使用 MouseEventExampleChildSprite 类来说明如何使用简单图像调度鼠标事件。 本示例将执行以下任务:
  1. 本示例声明了有关大小(100 x 100 像素)和背景颜色(橙色)的属性,以便在稍后绘制正方形时使用。
  2. 构造函数创建新的 ChildSprite 对象 child。 其构造函数首先通过调用其 draw() 方法在坐标 (0,0) 处绘制一个 100 x 100 像素的橙色正方形,然后添加七个事件侦听器/订阅者。
    • click / clickHandler():当用户用鼠标左键在正方形上单击时调度。
    • doubleClick / doubleClickHandler():当用户在正方形上双击鼠标左键时调度。
    • mouseDown / mouseDownHandler():当单击 ChildSprite 对象(橙色正方形)时,会在屏幕上输出 trace() 消息,然后调用 ChildSprite.draw(),这样就会在 mouseOverHandler() 中绘制一个代替浅蓝色正方形的深黄色正方形。 mouseDownHandler() 方法还添加一个 mouseMove 事件侦听器和 mouseMoveHandler() 订阅者(如下所述),以处理鼠标的移动。 然后调用 startDrag() 方法,此方法允许拖动 Sprite 对象。
    • mouseOut / mouseOutHandler():每次指针离开正方形区域时调度。 调用 draw() 方法以将正方形恢复为其正常大小和颜色。
    • mouseOver/mouseOverHandler():当鼠标指针位于正方形上方时调度。 此方法可以重绘正方形,以使正方形更大并且其背景颜色为深黄色。
    • mouseUp / mouseUpHandler():当用户释放鼠标按键时,将删除 mouseMove 事件侦听器并调用 stopDrag,这样就会冻结当前位置的正方形。
    • mouseMove / mouseMoveHandler():只要用户按下鼠标左键,此方法就会指示 Flash Player 连续重绘橙色正方形。
    • mouseWheel / mouseWheelHandler():当用户在正方形上方滚动鼠标滚轮时调度。
  3. 然后 ChildSprite 实例 child 通过 addChild()(立即绘制橙色正方形)添加到显示列表中。

注意:

package {
    import flash.display.Sprite;

    public class MouseEventExample extends Sprite {
        private var size:uint = 100;
        private var bgColor:uint = 0xFFCC00;

        public function MouseEventExample() {
            var child:ChildSprite = new ChildSprite();
            addChild(child);
        }
    }
}

import flash.display.Sprite;
import flash.events.MouseEvent;

class ChildSprite extends Sprite {
    private var size:uint = 50;
    private var overSize:uint = 60;
    private var backgroundColor:uint = 0xFFCC00;
    private var overColor:uint = 0xCCFF00;
    private var downColor:uint = 0x00CCFF;

    public function ChildSprite() {
        draw(size, size, backgroundColor);
        addEventListener(MouseEvent.CLICK, clickHandler);
        addEventListener(MouseEvent.DOUBLE_CLICK, doubleClickHandler);
        addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);
        addEventListener(MouseEvent.MOUSE_OUT, mouseOutHandler);
        addEventListener(MouseEvent.MOUSE_OVER, mouseOverHandler);
        addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);
        addEventListener(MouseEvent.MOUSE_WHEEL, mouseWheelHandler);
    }

    private function draw(w:uint, h:uint, bgColor:uint):void {
        graphics.clear();
        graphics.beginFill(bgColor);
        graphics.drawRect(0, 0, w, h);
        graphics.endFill();
    }

    private function clickHandler(event:MouseEvent):void {
        trace("clickHandler");
    }

    private function doubleClickHandler(event:MouseEvent):void {
        trace("doubleClickHandler");
    }

    private function mouseDownHandler(event:MouseEvent):void {
        trace("mouseDownHandler");
        draw(overSize, overSize, downColor);

        var sprite:Sprite = Sprite(event.target);
        sprite.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
        sprite.startDrag();
    }

    private function mouseMoveHandler(event:MouseEvent):void {
        trace("mouseMoveHandler");
        event.updateAfterEvent();
    }

    private function mouseOutHandler(event:MouseEvent):void {
        trace("mouseOutHandler");
        draw(size, size, backgroundColor);
    }

    private function mouseOverHandler(event:MouseEvent):void {
        trace("mouseOverHandler");
        draw(overSize, overSize, overColor);
    }

    private function mouseWheelHandler(event:MouseEvent):void {
        trace("mouseWheelHandler delta: " + event.delta);
    }

    private function mouseUpHandler(event:MouseEvent):void {
        trace("mouseUpHandler");
        var sprite:Sprite = Sprite(event.target);
        sprite.removeEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
        sprite.stopDrag();
        draw(overSize, overSize, overColor);
    }
}




 

评论添加到页面后给我发送电子邮件 | 评论报告

当前页: http://livedocs.adobe.com/flash/9.0_cn/ActionScriptLangRefV3/flash/events/MouseEvent.html