flash.events
public class MouseEvent
继承MouseEvent Inheritance Event Inheritance Object
子类 AutomationDragEvent, ChartEvent, ChartItemEvent, DragEvent, FlexMouseEvent, LegendMouseEvent, NativeDragEvent, ScreenMouseEvent

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

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

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

查看示例

另请参见

About keyboard events


公共属性
 属性定义方
  altKey : Boolean
指示 Alt 键是处于活动状态 (true) 还是非活动状态 (false)。
MouseEvent
 Inheritedbubbles : Boolean
[只读 (read-only)] 指示事件是否为冒泡事件。
Event
  buttonDown : Boolean
指示鼠标主按键是已按下 (true) 还是未按下 (false)。
MouseEvent
 Inheritedcancelable : Boolean
[只读 (read-only)] 指示是否可以阻止与事件相关联的行为。
Event
  AIR-only clickCount : int
[只读 (read-only)] 指示鼠标按下事件是否为多击序列的一部分。
MouseEvent
  AIR-only commandKey : Boolean
指示是否已激活 Command 键(仅限 Mac)。commandKey 属性的值将与 Mac 中 ctrlKey 属性的值相同。
MouseEvent
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  AIR-only controlKey : Boolean
指示在 Mac 中是否已激活 Control 键,以及在 Windows 或 Linux 中是否已激活 Ctrl 键。
MouseEvent
  ctrlKey : Boolean
在 Windows 或 Linux 中,指示 Ctrl 键是处于活动状态 (true) 还是非活动状态 (false)。
MouseEvent
 InheritedcurrentTarget : Object
[只读 (read-only)] 当前正在使用某个事件侦听器处理 Event 对象的对象。
Event
  delta : int
指示用户将鼠标滚轮每滚动一个单位应滚动多少行。
MouseEvent
 InheritedeventPhase : uint
[只读 (read-only)] 事件流中的当前阶段。
Event
  isRelatedObjectInaccessible : Boolean
如果为 true,则 relatedObject 属性是出于与安全沙箱相关的原因而设置为 null 的。
MouseEvent
  localX : Number
事件发生点的相对于包含 Sprite 的水平坐标。
MouseEvent
  localY : Number
事件发生点的相对于包含 Sprite 的垂直坐标。
MouseEvent
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
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
公共方法
 方法定义方
  
AIR-only MouseEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, localX:Number = NaN, localY:Number = NaN, relatedObject:InteractiveObject = null, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, buttonDown:Boolean = false, delta:int = 0, commandKey:Boolean = false, controlKey:Boolean = false, clickCount:int = 0)
创建一个 Event 对象,其中包含有关鼠标事件的信息。
MouseEvent
  
创建 MouseEvent 对象的副本,并设置每个属性的值以匹配原始属性值。
MouseEvent
 Inherited
formatToString(className:String, ... arguments):String
用于在自定义 ActionScript 3.0 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 或 Adobe AIR 在此事件处理完成后呈现结果。
MouseEvent
 Inherited
返回指定对象的原始值。
Object
公共常量
 常量定义方
 InheritedACTIVATE : String = "activate"
[静态] ACTIVATE 常量定义 activate 事件对象的 type 属性的值。
Event
 InheritedADDED : String = "added"
[静态] Event.ADDED 常量定义 added 事件对象的 type 属性值。
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[静态] Event.ADDED_TO_STAGE 常量定义 addedToStage 事件对象的 type 属性值。
Event
 InheritedCANCEL : String = "cancel"
[静态] Event.CANCEL 常量定义 cancel 事件对象的 type 属性的值。
Event
 InheritedCHANGE : String = "change"
[静态] Event.CHANGE 常量定义 change 事件对象的 type 属性值。
Event
 InheritedCLEAR : String = "clear"
[静态] Event.CLEAR 常量定义 clear 事件对象的 type 属性的值。
Event
  CLICK : String = "click"
[静态] 定义 click 事件对象的 type 属性值。
MouseEvent
 InheritedCLOSE : String = "close"
[静态] Event.CLOSE 常量定义 close 事件对象的 type 属性的值。
Event
 InheritedAIR-only CLOSING : String = "closing"
[静态] Event.CLOSING 常量定义 closing 事件对象的 type 属性值。
Event
 InheritedCOMPLETE : String = "complete"
[静态] Event.COMPLETE 常量定义 complete 事件对象的 type 属性值。
Event
 InheritedCONNECT : String = "connect"
[静态] Event.CONNECT 常量定义 connect 事件对象的 type 属性值。
Event
  AIR-only CONTEXT_MENU : String = "contextMenu"
[静态] MouseEvent.CONTEXT_MENU 常量定义 contextMenu 事件对象的 type 属性的值。
MouseEvent
 InheritedCOPY : String = "copy"
[静态] 定义 copy 事件对象的 type 属性值。
Event
 InheritedCUT : String = "cut"
[静态] 定义 cut 事件对象的 type 属性值。
Event
 InheritedDEACTIVATE : String = "deactivate"
[静态] Event.DEACTIVATE 常量定义 deactivate 事件对象的 type 属性值。
Event
 InheritedDISPLAYING : String = "displaying"
[静态] Event.DISPLAYING 常量定义 displaying 事件对象的 type 属性值。
Event
  DOUBLE_CLICK : String = "doubleClick"
[静态] 定义 doubleClick 事件对象的 type 属性值。
MouseEvent
 InheritedENTER_FRAME : String = "enterFrame"
[静态] Event.ENTER_FRAME 常量定义 enterFrame 事件对象的 type 属性值。
Event
 InheritedEXIT_FRAME : String = "exitFrame"
[静态] Event.EXIT_FRAME 常量定义 exitFrame 事件对象的 type 属性的值。
Event
 InheritedAIR-only EXITING : String = "exiting"
[静态] Event.EXITING 常量定义 exiting 事件对象的 type 属性值。
Event
 InheritedFRAME_CONSTRUCTED : String = "frameConstructed"
[静态] Event.FRAME_CONSTRUCTED 常量定义 frameConstructed 事件对象的 type 属性的值。
Event
 InheritedFULLSCREEN : String = "fullScreen"
[静态] Event.FULL_SCREEN 常量定义 fullScreen 事件对象的 type 属性值。
Event
 InheritedAIR-only HTML_BOUNDS_CHANGE : String = "htmlBoundsChange"
[静态] Event.HTML_BOUNDS_CHANGE 常量定义 htmlBoundsChange 事件对象的 type 属性值。
Event
 InheritedAIR-only HTML_DOM_INITIALIZE : String = "htmlDOMInitialize"
[静态] Event.HTML_DOM_INITIALIZE 常量定义 htmlDOMInitialize 事件对象的 type 属性值。
Event
 InheritedAIR-only HTML_RENDER : String = "htmlRender"
[静态] Event.HTML_RENDER 常量定义 htmlRender 事件对象的 type 属性值。
Event
 InheritedID3 : String = "id3"
[静态] Event.ID3 常量定义 id3 事件对象的 type 属性值。
Event
 InheritedINIT : String = "init"
[静态] Event.INIT 常量定义 init 事件对象的 type 属性值。
Event
 InheritedAIR-only LOCATION_CHANGE : String = "locationChange"
[静态] Event.LOCATION_CHANGE 常量定义 locationChange 事件对象的 type 属性值。
Event
  AIR-only MIDDLE_CLICK : String = "middleClick"
[静态] 定义 middleClick 事件对象的 type 属性值。
MouseEvent
  AIR-only MIDDLE_MOUSE_DOWN : String = "middleMouseDown"
[静态] 定义 middleMouseDown 事件对象的 type 属性值。
MouseEvent
  AIR-only MIDDLE_MOUSE_UP : String = "middleMouseUp"
[静态] 定义 middleMouseUp 事件对象的 type 属性值。
MouseEvent
  MOUSE_DOWN : String = "mouseDown"
[静态] 定义 mouseDown 事件对象的 type 属性值。
MouseEvent
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[静态] Event.MOUSE_LEAVE 常量定义 mouseLeave 事件对象的 type 属性值。
Event
  MOUSE_MOVE : String = "mouseMove"
[静态] 定义 mouseMove 事件对象的 type 属性值。
MouseEvent
  MOUSE_OUT : String = "mouseOut"
[静态] 定义 mouseOut 事件对象的 type 属性值。
MouseEvent
  MOUSE_OVER : String = "mouseOver"
[静态] 定义 mouseOver 事件对象的 type 属性值。
MouseEvent
  MOUSE_UP : String = "mouseUp"
[静态] 定义 mouseUp 事件对象的 type 属性值。
MouseEvent
  MOUSE_WHEEL : String = "mouseWheel"
[静态] 定义 mouseWheel 事件对象的 type 属性值。
MouseEvent
 InheritedAIR-only NETWORK_CHANGE : String = "networkChange"
[静态] Event.NETWORK_CHANGE 常量定义 networkChange 事件对象的 type 属性值。
Event
 InheritedOPEN : String = "open"
[静态] Event.OPEN 常量用于定义 open 事件对象的 type 属性值。
Event
 InheritedPASTE : String = "paste"
[静态] Event.PASTE 常量定义 paste 事件对象的 type 属性的值。
Event
 InheritedREMOVED : String = "removed"
[静态] Event.REMOVED 常量定义 removed 事件对象的 type 属性值。
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[静态] Event.REMOVED_FROM_STAGE 常量定义 removedFromStage 事件对象的 type 属性值。
Event
 InheritedRENDER : String = "render"
[静态] Event.RENDER 常量定义 render 事件对象的 type 属性的值。
Event
 InheritedRESIZE : String = "resize"
[静态] Event.RESIZE 常量定义 resize 事件对象的 type 属性的值。
Event
  AIR-only RIGHT_CLICK : String = "rightClick"
[静态] 定义 rightClick 事件对象的 type 属性值。
MouseEvent
  AIR-only RIGHT_MOUSE_DOWN : String = "rightMouseDown"
[静态] 定义 rightMouseDown 事件对象的 type 属性值。
MouseEvent
  AIR-only RIGHT_MOUSE_UP : String = "rightMouseUp"
[静态] 定义 rightMouseUp 事件对象的 type 属性值。
MouseEvent
  ROLL_OUT : String = "rollOut"
[静态] 定义 rollOut 事件对象的 type 属性值。
MouseEvent
  ROLL_OVER : String = "rollOver"
[静态] 定义 rollOver 事件对象的 type 属性值。
MouseEvent
 InheritedSCROLL : String = "scroll"
[静态] Event.SCROLL 常量定义 scroll 事件对象的 type 属性值。
Event
 InheritedSELECT : String = "select"
[静态] Event.SELECT 常量定义 select 事件对象的 type 属性的值。
Event
 InheritedSELECT_ALL : String = "selectAll"
[静态] Event.SELECT_ALL 常量定义 selectAll 事件对象的 type 属性的值。
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[静态] Event.SOUND_COMPLETE 常量定义 soundComplete 事件对象的 type 属性值。
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[静态] Event.TAB_CHILDREN_CHANGE 常量定义 tabChildrenChange 事件对象的 type 属性值。
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[静态] Event.TAB_ENABLED_CHANGE 常量定义 tabEnabledChange 事件对象的 type 属性值。
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[静态] Event.TAB_INDEX_CHANGE 常量定义 tabIndexChange 事件对象的 type 属性值。
Event
 InheritedUNLOAD : String = "unload"
[静态] Event.UNLOAD 常量定义 unload 事件对象的 type 属性值。
Event
 InheritedAIR-only USER_IDLE : String = "userIdle"
[静态] Event.USER_IDLE 常量定义 userIdle 事件对象的 type 属性值。
Event
 InheritedAIR-only USER_PRESENT : String = "userPresent"
[静态] Event.USER_PRESENT 常量定义 userPresent 事件对象的 type 属性值。
Event
属性详细信息
altKey属性
altKey:Boolean  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

指示 Alt 键是处于活动状态 (true) 还是非活动状态 (false)。仅 Windows 和 Linux 操作系统支持。



实现
    public function get altKey():Boolean
    public function set altKey(value:Boolean):void
buttonDown属性 
buttonDown:Boolean  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

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



实现
    public function get buttonDown():Boolean
    public function set buttonDown(value:Boolean):void
AIR-only clickCount属性 
clickCount:int  [只读 (read-only)]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

指示鼠标按下事件是否为多击序列的一部分。对于除 MouseEvent.mouseDownMouseEvent.mouseUpMouseEvent.middleMouseDownMouseEvent.middleMouseUpMouseEvent.rightMouseDownMouseEvent.rightMouseUp 以外的所有鼠标事件,此参数将为零。使用 clickCount 参数可以侦听单击、双击或任何多击序列。例如,初始 MouseEvent.mouseDownMouseEvent.mouseUpclickCount 为 1,双击序列中的第二个 MouseEvent.mouseDownMouseEvent.mouseUpclickCount 为 2。如果充分地移动鼠标或多击序列由于某种原因中断,则下一个 MouseEvent.mouseDown 的 clickCount 将为 1。doubleClick 事件将会继续正常触发。



实现
    public function get clickCount():int
AIR-only commandKey属性 
commandKey:Boolean  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

指示是否已激活 Command 键(仅限 Mac)。

commandKey 属性的值将与 Mac 中 ctrlKey 属性的值相同。在 Windows 或 Linux 中始终为 false。



实现
    public function get commandKey():Boolean
    public function set commandKey(value:Boolean):void
AIR-only controlKey属性 
controlKey:Boolean  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

指示在 Mac 中是否已激活 Control 键,以及在 Windows 或 Linux 中是否已激活 Ctrl 键。



实现
    public function get controlKey():Boolean
    public function set controlKey(value:Boolean):void
ctrlKey属性 
ctrlKey:Boolean  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

在 Windows 或 Linux 中,指示 Ctrl 键是处于活动状态 (true) 还是非活动状态 (false)。在 Macintosh 中,指示是否已激活 Control 键或 Command 键。



实现
    public function get ctrlKey():Boolean
    public function set ctrlKey(value:Boolean):void
delta属性 
delta:int  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

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



实现
    public function get delta():int
    public function set delta(value:int):void
isRelatedObjectInaccessible属性 
isRelatedObjectInaccessible:Boolean  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 10

如果为 true,则 relatedObject 属性是出于与安全沙箱相关的原因而设置为 null 的。如果 relatedObject 的标称值是对其他沙箱中的 DisplayObject 的引用,则 relatedObject 将设置为 null,除非具有双向跨越此沙箱边界的权限。通过以下方式确立权限:从 SWF 文件调用 Security.allowDomain();或者通过从图像文件的服务器提供策略文件,然后在加载图像时设置 LoaderContext.checkPolicyFile 属性。



实现
    public function get isRelatedObjectInaccessible():Boolean
    public function set isRelatedObjectInaccessible(value:Boolean):void

另请参见

localX属性 
localX:Number  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

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



实现
    public function get localX():Number
    public function set localX(value:Number):void

示例
如何使用示例
有关如何使用此属性的说明,请参阅 MOUSE_MOVE 常量的示例。
localY属性 
localY:Number  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

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



实现
    public function get localY():Number
    public function set localY(value:Number):void

示例
如何使用示例
有关如何使用此属性的说明,请参阅 MOUSE_MOVE 常量的示例。
relatedObject属性 
relatedObject:InteractiveObject  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

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

在以下两种情况下,此属性的值可以为 null:不存在任何相关对象;存在相关对象,但该对象位于您无法访问的安全沙箱中。使用 isRelatedObjectInaccessible() 属性可确定上述哪一个原因适用。



实现
    public function get relatedObject():InteractiveObject
    public function set relatedObject(value:InteractiveObject):void

另请参见

shiftKey属性 
shiftKey:Boolean  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 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
运行时版本: AIR 1.0 Flash Player 9

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



实现
    public function get stageX():Number

示例
如何使用示例
有关如何使用此属性的说明,请参阅 MOUSE_MOVE 常量的示例。
stageY属性 
stageY:Number  [只读 (read-only)]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

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



实现
    public function get stageY():Number

示例
如何使用示例
有关如何使用此属性的说明,请参阅 MOUSE_MOVE 常量的示例。
构造函数详细信息
AIR-only MouseEvent()构造函数
public function MouseEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, localX:Number = NaN, localY:Number = NaN, relatedObject:InteractiveObject = null, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, buttonDown:Boolean = false, delta:int = 0, commandKey:Boolean = false, controlKey:Boolean = false, clickCount:int = 0)

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

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

参数
type:String — 事件的类型。可能值为:MouseEvent.CLICKMouseEvent.DOUBLE_CLICKMouseEvent.MOUSE_DOWNMouseEvent.MOUSE_MOVEMouseEvent.MOUSE_OUTMouseEvent.MOUSE_OVERMouseEvent.MOUSE_UPMouseEvent.MIDDLE_CLICKMouseEvent.MIDDLE_MOUSE_DOWNMouseEvent.MIDDLE_MOUSE_UPMouseEvent.RIGHT_CLICKMouseEvent.RIGHT_MOUSE_DOWNMouseEvent.RIGHT_MOUSE_UPMouseEvent.MOUSE_WHEELMouseEvent.ROLL_OUTMouseEvent.ROLL_OVER
 
bubbles:Boolean (default = true) — 确定 Event 对象是否参与事件流的冒泡阶段。
 
cancelable:Boolean (default = false) — 确定是否可以取消 Event 对象。
 
localX:Number (default = NaN) — 事件发生点的相对于包含 Sprite 的水平坐标。
 
localY:Number (default = NaN) — 事件发生点的相对于包含 Sprite 的垂直坐标。
 
relatedObject:InteractiveObject (default = null) — 受事件影响的补充 InteractiveObject 实例。例如,发生 mouseOut 事件时,relatedObject 表示指针设备当前所指向的显示列表对象。
 
ctrlKey:Boolean (default = false) — 在 Windows 或 Linux 中,指示是否已激活 Ctrl 键。在 Mac 中,指示是否已激活 Ctrl 键或 Command 键。
 
altKey:Boolean (default = false) — 指示是否已激活 Alt 键(仅限 Windows 或 Linux)。
 
shiftKey:Boolean (default = false) — 指示是否已激活 Shift 键。
 
buttonDown:Boolean (default = false) — 指示是否按下了鼠标主按键。
 
delta:int (default = 0) — 指示用户将鼠标滚轮每滚动一个单位应滚动多少行。正 delta 值指示向上滚动;负值指示向下滚动。通常所设的值为 1 到 3;值越大,滚动得越快。此参数仅用于 MouseEvent.mouseWheel 事件。
 
commandKey:Boolean (default = false) — 指示是否已激活 Command 键(仅限 Mac)。此参数仅用于 MouseEvent.clickMouseEvent.mouseDownMouseEvent.mouseUpMouseEvent.middleClickMouseEvent.middleMouseDownMouseEvent.middleMouseUpMouseEvent.rightClickMouseEvent.rightMouseDownMouseEvent.rightMouseUpMouseEvent.doubleClick 事件。
 
controlKey:Boolean (default = false) — 指示是否已激活 Control 或 Ctrl 键。此参数仅用于 MouseEvent.clickMouseEvent.mouseDownMouseEvent.mouseUpMouseEvent.middleClickMouseEvent.middleMouseDownMouseEvent.middleMouseUpMouseEvent.rightClickMouseEvent.rightMouseDownMouseEvent.rightMouseUpMouseEvent.doubleClick 事件。
 
clickCount:int (default = 0) — 指示鼠标事件是否为多击序列的一部分。对于除 MouseEvent.mouseDownMouseEvent.mouseUpMouseEvent.middleMouseDownMouseEvent.middleMouseUpMouseEvent.rightMouseDownMouseEvent.rightMouseUp 以外的所有鼠标事件,此参数将为零。使用 clickCount 参数可以侦听单击、双击或任何多击序列。
方法详细信息
clone()方法
override public function clone():Event

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

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

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

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

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

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

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

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

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

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

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

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

此事件具有以下属性:

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

另请参见

AIR-only CONTEXT_MENU常量 
public static const CONTEXT_MENU:String = "contextMenu"

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

MouseEvent.CONTEXT_MENU 常量定义 contextMenu 事件对象的 type 属性的值。

此事件具有以下属性:

属性
altKey 如果 Alt 键处于活动状态,则为 true(Windows 或 Linux)。
bubbles true
buttonDown 如果按下鼠标右键,则为 true;否则为 false
cancelable false;不能取消默认行为。
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 或 Control 键处于活动状态,则为 true,如果处于非活动状态,则为 false
ctrlKey 在 Windows 或 Linux 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 true。否则为 false
currentTarget 当前正在使用某个事件侦听器处理 Event 对象的对象。
localX 事件发生点的相对于包含 Sprite 的水平坐标。
localY 事件发生点的相对于包含 Sprite 的垂直坐标。
shiftKey 如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 键处于活动状态,则为 true;如果处于非活动状态,则为 false
clickCount 鼠标单击次数,指示该事件是否为多击序列的一部分。
stageX 事件发生点在全局舞台坐标中的水平坐标。
stageY 事件发生点在全局舞台坐标中的垂直坐标。
target 指针设备下的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

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

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

定义 doubleClick 事件对象的 type 属性值。对象的 doubleClickEnabled 属性必须为 true 以生成 doubleClick 事件。

此事件具有以下属性:

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

另请参见

AIR-only MIDDLE_CLICK常量 
public static const MIDDLE_CLICK:String = "middleClick"

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

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

此事件具有以下属性:

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

另请参见

AIR-only MIDDLE_MOUSE_DOWN常量 
public static const MIDDLE_MOUSE_DOWN:String = "middleMouseDown"

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

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

此事件具有以下属性:

属性
altKey 如果 Alt 键处于活动状态,则为 true(Windows 或 Linux)。
bubbles true
buttonDown 如果按下鼠标中键,则为 true;否则为 false
cancelable false;不能取消默认行为。
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 或 Control 键处于活动状态,则为 true,如果处于非活动状态,则为 false
ctrlKey 在 Windows 或 Linux 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 true。否则为 false
currentTarget 当前正在使用某个事件侦听器处理 Event 对象的对象。
localX 事件发生点的相对于包含 Sprite 的水平坐标。
localY 事件发生点的相对于包含 Sprite 的垂直坐标。
shiftKey 如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 键处于活动状态,则为 true;如果处于非活动状态,则为 false
clickCount 鼠标单击次数,指示该事件是否为多击序列的一部分。
stageX 事件发生点在全局舞台坐标中的水平坐标。
stageY 事件发生点在全局舞台坐标中的垂直坐标。
target 指针设备下的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见

AIR-only MIDDLE_MOUSE_UP常量 
public static const MIDDLE_MOUSE_UP:String = "middleMouseUp"

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

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

此事件具有以下属性:

属性
altKey 如果 Alt 键处于活动状态,则为 true(Windows 或 Linux)。
bubbles true
buttonDown 如果按下鼠标中键,则为 true;否则为 false
cancelable false;不能取消默认行为。
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 或 Control 键处于活动状态,则为 true,如果处于非活动状态,则为 false
ctrlKey 在 Windows 或 Linux 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 true。否则为 false
currentTarget 当前正在使用某个事件侦听器处理 Event 对象的对象。
localX 事件发生点的相对于包含 Sprite 的水平坐标。
localY 事件发生点的相对于包含 Sprite 的垂直坐标。
shiftKey 如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 键处于活动状态,则为 true;如果处于非活动状态,则为 false
clickCount 鼠标单击次数,指示该事件是否为多击序列的一部分。
stageX 事件发生点在全局舞台坐标中的水平坐标。
stageY 事件发生点在全局舞台坐标中的垂直坐标。
target 指针设备下的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见

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

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

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

此事件具有以下属性:

属性
altKey 如果 Alt 键处于活动状态,则为 true(Windows 或 Linux)。
bubbles true
buttonDown 如果按下鼠标主按键,则为 true;否则为 false
cancelable false;不能取消默认行为。
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 或 Control 键处于活动状态,则为 true,如果处于非活动状态,则为 false
ctrlKey 在 Windows 和 Linux 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 true。否则为 false
currentTarget 当前正在使用某个事件侦听器处理 Event 对象的对象。
localX 事件发生点的相对于包含 Sprite 的水平坐标。
localY 事件发生点的相对于包含 Sprite 的垂直坐标。
shiftKey 如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
clickCount 鼠标单击次数,指示该事件是否为多击序列的一部分。
stageX 事件发生点在全局舞台坐标中的水平坐标。
stageY 事件发生点在全局舞台坐标中的垂直坐标。
target 指针设备下的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见


示例
如何使用示例
有关如何使用此常量的说明,请参阅 MOUSE_MOVE 常量的示例。
MOUSE_MOVE常量 
public static const MOUSE_MOVE:String = "mouseMove"

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

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

此事件具有以下属性:

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

另请参见


示例

下面的示例是一个简单的绘图程序。用户可以在主 Sprite 对象上或在较小的矩形 Sprite 对象上进行绘制。

在构造函数中, 创建了一个矩形 innerRect Sprite 对象并将线条样式设置为绿色。用于在 MouseEvent_MOUSE_MOVEExample Sprite 容器上进行绘制的线条样式设置为红色。为应用程序的主 Sprite 对象和 innerRect Sprite 对象添加侦听 MouseEvent.MOUSE_UPMouseEvent.MOUSE_DOWN 事件的独立事件侦听器。在这两种情况下,鼠标按下事件侦听器方法将当前绘画位置移动到鼠标指针的位置并为 MouseEvent.MOUSE_MOVE 事件添加一个侦听器。移动鼠标指针时,调用的事件侦听器方法将跟随指针并使用 graphics.LineTo() 方法绘制一条直线。(注意:innerRect Sprite 对象将遮蔽在矩形后面绘制的主 Sprite 对象的红线。)在发生 MouseEvent.MOUSE_UP 事件时,将删除 MOUSE_MOVE 事件的侦听器并停止绘画。

package {
    import flash.display.Sprite;
    import flash.display.Graphics;
    import flash.events.MouseEvent;

    public class MouseEvent_MOUSE_MOVEExample extends Sprite {
        private var innerRect:Sprite = new Sprite();
        
        public function MouseEvent_MOUSE_MOVEExample() {

            graphics.lineStyle(3, 0xFF0000, 1);
            stage.addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);
            stage.addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);

            innerRect.graphics.lineStyle(1, 0x00FF00, 1);
            innerRect.graphics.beginFill(0xFFFFFF);
            innerRect.graphics.drawRect(10, 10, 200, 200);
            innerRect.graphics.endFill();
            innerRect.addEventListener(MouseEvent.MOUSE_DOWN, innerRectMouseDownHandler);
            innerRect.addEventListener(MouseEvent.MOUSE_UP, innerRectMouseUpHandler);
            addChild(innerRect);
        }

        private function mouseDownHandler(event:MouseEvent):void {
            graphics.moveTo(event.stageX, event.stageY);
            stage.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
        }
    
        private function mouseMoveHandler(event:MouseEvent):void {
            graphics.lineTo(event.stageX, event.stageY);
        }    
    
        private function mouseUpHandler(event:MouseEvent):void {
            stage.removeEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
        }

        private function innerRectMouseDownHandler(event:MouseEvent):void {
            innerRect.graphics.moveTo(event.localX, event.localY);
            innerRect.addEventListener(MouseEvent.MOUSE_MOVE, innerRectMouseMoveHandler);
        }
    
        private function innerRectMouseMoveHandler(event:MouseEvent):void {
            innerRect.graphics.lineTo(event.localX, event.localY);
        }    
    
        private function innerRectMouseUpHandler(event:MouseEvent):void {
            innerRect.removeEventListener(MouseEvent.MOUSE_MOVE, innerRectMouseMoveHandler);
        }
    }
}
MOUSE_OUT常量 
public static const MOUSE_OUT:String = "mouseOut"

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

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

此事件具有以下属性:

属性
altKey 如果 Alt 键处于活动状态,则为 true(Windows 或 Linux)。
bubbles true
buttonDown 如果按下鼠标主按键,则为 true;否则为 false
cancelable false;不能取消默认行为。
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 或 Control 键处于活动状态,则为 true,如果处于非活动状态,则为 false
ctrlKey 在 Windows 或 Linux 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 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
运行时版本: AIR 1.0 Flash Player 9

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

此事件具有以下属性:

属性
altKey 如果 Alt 键处于活动状态,则为 true(Windows 或 Linux)。
bubbles true
buttonDown 如果按下鼠标主按键,则为 true;否则为 false
cancelable false;不能取消默认行为。
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 或 Control 键处于活动状态,则为 true,如果处于非活动状态,则为 false
ctrlKey 在 Windows 或 Linux 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 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
运行时版本: AIR 1.0 Flash Player 9

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

此事件具有以下属性:

属性
altKey 如果 Alt 键处于活动状态,则为 true(Windows 或 Linux)。
bubbles true
buttonDown 如果按下鼠标主按键,则为 true;否则为 false
cancelable false;不能取消默认行为。
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 或 Control 键处于活动状态,则为 true,如果处于非活动状态,则为 false
ctrlKey 在 Windows 或 Linux 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 true。否则为 false
currentTarget 当前正在使用某个事件侦听器处理 Event 对象的对象。
localX 事件发生点的相对于包含 Sprite 的水平坐标。
localY 事件发生点的相对于包含 Sprite 的垂直坐标。
shiftKey 如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 键处于活动状态,则为 true;如果处于非活动状态,则为 false
clickCount 鼠标单击次数,指示该事件是否为多击序列的一部分。
stageX 事件发生点在全局舞台坐标中的水平坐标。
stageY 事件发生点在全局舞台坐标中的垂直坐标。
target 指针设备下的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见


示例
如何使用示例
有关如何使用此常量的说明,请参阅 MOUSE_MOVE 常量的示例。
MOUSE_WHEEL常量 
public static const MOUSE_WHEEL:String = "mouseWheel"

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

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

此事件具有以下属性:

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

另请参见

AIR-only RIGHT_CLICK常量 
public static const RIGHT_CLICK:String = "rightClick"

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

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

此事件具有以下属性:

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

另请参见

AIR-only RIGHT_MOUSE_DOWN常量 
public static const RIGHT_MOUSE_DOWN:String = "rightMouseDown"

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

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

此事件具有以下属性:

属性
altKey 如果 Alt 键处于活动状态,则为 true(Windows 或 Linux)。
bubbles true
buttonDown 如果按下鼠标右键,则为 true;否则为 false
cancelable false;不能取消默认行为。
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 或 Control 键处于活动状态,则为 true,如果处于非活动状态,则为 false
ctrlKey 在 Windows 或 Linux 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 true。否则为 false
currentTarget 当前正在使用某个事件侦听器处理 Event 对象的对象。
localX 事件发生点的相对于包含 Sprite 的水平坐标。
localY 事件发生点的相对于包含 Sprite 的垂直坐标。
shiftKey 如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 键处于活动状态,则为 true;如果处于非活动状态,则为 false
clickCount 鼠标单击次数,指示该事件是否为多击序列的一部分。
stageX 事件发生点在全局舞台坐标中的水平坐标。
stageY 事件发生点在全局舞台坐标中的垂直坐标。
target 指针设备下的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见

AIR-only RIGHT_MOUSE_UP常量 
public static const RIGHT_MOUSE_UP:String = "rightMouseUp"

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

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

此事件具有以下属性:

属性
altKey 如果 Alt 键处于活动状态,则为 true(Windows 或 Linux)。
bubbles true
buttonDown 如果按下鼠标右键,则为 true;否则为 false
cancelable false;不能取消默认行为。
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 或 Control 键处于活动状态,则为 true,如果处于非活动状态,则为 false
ctrlKey 在 Windows 或 Linux 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 true。否则为 false
currentTarget 当前正在使用某个事件侦听器处理 Event 对象的对象。
localX 事件发生点的相对于包含 Sprite 的水平坐标。
localY 事件发生点的相对于包含 Sprite 的垂直坐标。
shiftKey 如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 键处于活动状态,则为 true;如果处于非活动状态,则为 false
clickCount 鼠标单击次数,指示该事件是否为多击序列的一部分。
stageX 事件发生点在全局舞台坐标中的水平坐标。
stageY 事件发生点在全局舞台坐标中的垂直坐标。
target 指针设备下的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见

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

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

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

此事件具有以下属性:

属性
altKey 如果 Alt 键处于活动状态,则为 true(Windows 或 Linux)。
bubbles false
buttonDown 如果按下鼠标主按键,则为 true;否则为 false
cancelable false;没有要取消的默认行为。
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 或 Control 键处于活动状态,则为 true,如果处于非活动状态,则为 false
ctrlKey 在 Windows 或 Linux 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 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
运行时版本: AIR 1.0 Flash Player 9

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

此事件具有以下属性:

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

另请参见

示例 如何使用示例
MouseEventExample.as

以下示例使用 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():作为 mouseDownHandler() 函数的一部分进行调用,在用户按住鼠标左键并拖动正方形时调度。
    • 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);
            doubleClickEnabled = true;
        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);
    }
}