包 | flash.events |
类 | public class MouseEvent |
继承 | MouseEvent Event Object |
子类 | AutomationDragEvent, ChartEvent, ChartItemEvent, DragEvent, FlexMouseEvent, LegendMouseEvent, NativeDragEvent, ScreenMouseEvent |
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 Flash Player 9 |
当包含嵌套节点时,鼠标事件指向在显示列表中可见的最深的可能嵌套节点。此节点称为目标节点。若要让目标节点的始祖接收鼠标事件的通知,请使用始祖节点上其 type
参数设置为您要检测的特定鼠标事件的 EventDispatcher.addEventListener()
。
另请参见
属性 | 定义方 | ||
---|---|---|---|
altKey : Boolean 指示 Alt 键是处于活动状态 (true) 还是非活动状态 (false)。 | MouseEvent | ||
bubbles : Boolean [只读 (read-only)] 指示事件是否为冒泡事件。 | Event | ||
buttonDown : Boolean 指示鼠标主按键是已按下 (true) 还是未按下 (false)。 | MouseEvent | ||
cancelable : Boolean [只读 (read-only)] 指示是否可以阻止与事件相关联的行为。 | Event | ||
clickCount : int [只读 (read-only)] 指示鼠标按下事件是否为多击序列的一部分。 | MouseEvent | ||
commandKey : Boolean 指示是否已激活 Command 键(仅限 Mac)。commandKey 属性的值将与 Mac 中 ctrlKey 属性的值相同。 | MouseEvent | ||
constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | ||
controlKey : Boolean 指示在 Mac 中是否已激活 Control 键,以及在 Windows 或 Linux 中是否已激活 Ctrl 键。 | MouseEvent | ||
ctrlKey : Boolean 在 Windows 或 Linux 中,指示 Ctrl 键是处于活动状态 (true) 还是非活动状态 (false)。 | MouseEvent | ||
currentTarget : Object [只读 (read-only)] 当前正在使用某个事件侦听器处理 Event 对象的对象。 | Event | ||
delta : int 指示用户将鼠标滚轮每滚动一个单位应滚动多少行。 | MouseEvent | ||
eventPhase : uint [只读 (read-only)] 事件流中的当前阶段。 | Event | ||
isRelatedObjectInaccessible : Boolean 如果为 true,则 relatedObject 属性是出于与安全沙箱相关的原因而设置为 null 的。 | MouseEvent | ||
localX : Number 事件发生点的相对于包含 Sprite 的水平坐标。 | MouseEvent | ||
localY : Number 事件发生点的相对于包含 Sprite 的垂直坐标。 | MouseEvent | ||
prototype : Object [静态]
对类或函数对象的原型对象的引用。 | Object | ||
relatedObject : InteractiveObject 对与事件相关的显示列表对象的引用。 | MouseEvent | ||
shiftKey : Boolean 指示 Shift 键是处于活动状态 (true) 还是非活动状态 (false)。 | MouseEvent | ||
stageX : Number [只读 (read-only)] 事件发生点在全局舞台坐标中的水平坐标。 | MouseEvent | ||
stageY : Number [只读 (read-only)] 事件发生点在全局舞台坐标中的垂直坐标。 | MouseEvent | ||
target : Object [只读 (read-only)] 事件目标。 | Event | ||
type : String [只读 (read-only)] 事件的类型。 | Event |
方法 | 定义方 | ||
---|---|---|---|
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 | ||
用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。 | Event | ||
指示对象是否已经定义了指定的属性。 | Object | ||
检查是否已对事件调用 preventDefault() 方法。 | Event | ||
指示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
如果可以取消事件的默认行为,则取消该行为。 | Event | ||
指示指定的属性是否存在、是否可枚举。 | Object | ||
设置循环操作动态属性的可用性。 | Object | ||
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。 | Event | ||
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。 | Event | ||
返回一个字符串,其中包含 MouseEvent 对象的所有属性。 | MouseEvent | ||
如果已修改显示列表,则将指示 Flash Player 或 Adobe AIR 在此事件处理完成后呈现结果。 | MouseEvent | ||
返回指定对象的原始值。 | Object |
常量 | 定义方 | ||
---|---|---|---|
ACTIVATE : String = "activate" [静态] ACTIVATE 常量定义 activate 事件对象的 type 属性的值。 | Event | ||
ADDED : String = "added" [静态] Event.ADDED 常量定义 added 事件对象的 type 属性值。 | Event | ||
ADDED_TO_STAGE : String = "addedToStage" [静态] Event.ADDED_TO_STAGE 常量定义 addedToStage 事件对象的 type 属性值。 | Event | ||
CANCEL : String = "cancel" [静态] Event.CANCEL 常量定义 cancel 事件对象的 type 属性的值。 | Event | ||
CHANGE : String = "change" [静态] Event.CHANGE 常量定义 change 事件对象的 type 属性值。 | Event | ||
CLEAR : String = "clear" [静态] Event.CLEAR 常量定义 clear 事件对象的 type 属性的值。 | Event | ||
CLICK : String = "click" [静态] 定义 click 事件对象的 type 属性值。 | MouseEvent | ||
CLOSE : String = "close" [静态] Event.CLOSE 常量定义 close 事件对象的 type 属性的值。 | Event | ||
CLOSING : String = "closing" [静态] Event.CLOSING 常量定义 closing 事件对象的 type 属性值。 | Event | ||
COMPLETE : String = "complete" [静态] Event.COMPLETE 常量定义 complete 事件对象的 type 属性值。 | Event | ||
CONNECT : String = "connect" [静态] Event.CONNECT 常量定义 connect 事件对象的 type 属性值。 | Event | ||
CONTEXT_MENU : String = "contextMenu" [静态] MouseEvent.CONTEXT_MENU 常量定义 contextMenu 事件对象的 type 属性的值。 | MouseEvent | ||
COPY : String = "copy" [静态] 定义 copy 事件对象的 type 属性值。 | Event | ||
CUT : String = "cut" [静态] 定义 cut 事件对象的 type 属性值。 | Event | ||
DEACTIVATE : String = "deactivate" [静态] Event.DEACTIVATE 常量定义 deactivate 事件对象的 type 属性值。 | Event | ||
DISPLAYING : String = "displaying" [静态] Event.DISPLAYING 常量定义 displaying 事件对象的 type 属性值。 | Event | ||
DOUBLE_CLICK : String = "doubleClick" [静态] 定义 doubleClick 事件对象的 type 属性值。 | MouseEvent | ||
ENTER_FRAME : String = "enterFrame" [静态] Event.ENTER_FRAME 常量定义 enterFrame 事件对象的 type 属性值。 | Event | ||
EXIT_FRAME : String = "exitFrame" [静态] Event.EXIT_FRAME 常量定义 exitFrame 事件对象的 type 属性的值。 | Event | ||
EXITING : String = "exiting" [静态] Event.EXITING 常量定义 exiting 事件对象的 type 属性值。 | Event | ||
FRAME_CONSTRUCTED : String = "frameConstructed" [静态] Event.FRAME_CONSTRUCTED 常量定义 frameConstructed 事件对象的 type 属性的值。 | Event | ||
FULLSCREEN : String = "fullScreen" [静态] Event.FULL_SCREEN 常量定义 fullScreen 事件对象的 type 属性值。 | Event | ||
HTML_BOUNDS_CHANGE : String = "htmlBoundsChange" [静态] Event.HTML_BOUNDS_CHANGE 常量定义 htmlBoundsChange 事件对象的 type 属性值。 | Event | ||
HTML_DOM_INITIALIZE : String = "htmlDOMInitialize" [静态] Event.HTML_DOM_INITIALIZE 常量定义 htmlDOMInitialize 事件对象的 type 属性值。 | Event | ||
HTML_RENDER : String = "htmlRender" [静态] Event.HTML_RENDER 常量定义 htmlRender 事件对象的 type 属性值。 | Event | ||
ID3 : String = "id3" [静态] Event.ID3 常量定义 id3 事件对象的 type 属性值。 | Event | ||
INIT : String = "init" [静态] Event.INIT 常量定义 init 事件对象的 type 属性值。 | Event | ||
LOCATION_CHANGE : String = "locationChange" [静态] Event.LOCATION_CHANGE 常量定义 locationChange 事件对象的 type 属性值。 | Event | ||
MIDDLE_CLICK : String = "middleClick" [静态] 定义 middleClick 事件对象的 type 属性值。 | MouseEvent | ||
MIDDLE_MOUSE_DOWN : String = "middleMouseDown" [静态] 定义 middleMouseDown 事件对象的 type 属性值。 | MouseEvent | ||
MIDDLE_MOUSE_UP : String = "middleMouseUp" [静态] 定义 middleMouseUp 事件对象的 type 属性值。 | MouseEvent | ||
MOUSE_DOWN : String = "mouseDown" [静态] 定义 mouseDown 事件对象的 type 属性值。 | MouseEvent | ||
MOUSE_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 | ||
NETWORK_CHANGE : String = "networkChange" [静态] Event.NETWORK_CHANGE 常量定义 networkChange 事件对象的 type 属性值。 | Event | ||
OPEN : String = "open" [静态] Event.OPEN 常量用于定义 open 事件对象的 type 属性值。 | Event | ||
PASTE : String = "paste" [静态] Event.PASTE 常量定义 paste 事件对象的 type 属性的值。 | Event | ||
REMOVED : String = "removed" [静态] Event.REMOVED 常量定义 removed 事件对象的 type 属性值。 | Event | ||
REMOVED_FROM_STAGE : String = "removedFromStage" [静态] Event.REMOVED_FROM_STAGE 常量定义 removedFromStage 事件对象的 type 属性值。 | Event | ||
RENDER : String = "render" [静态] Event.RENDER 常量定义 render 事件对象的 type 属性的值。 | Event | ||
RESIZE : String = "resize" [静态] Event.RESIZE 常量定义 resize 事件对象的 type 属性的值。 | Event | ||
RIGHT_CLICK : String = "rightClick" [静态] 定义 rightClick 事件对象的 type 属性值。 | MouseEvent | ||
RIGHT_MOUSE_DOWN : String = "rightMouseDown" [静态] 定义 rightMouseDown 事件对象的 type 属性值。 | MouseEvent | ||
RIGHT_MOUSE_UP : String = "rightMouseUp" [静态] 定义 rightMouseUp 事件对象的 type 属性值。 | MouseEvent | ||
ROLL_OUT : String = "rollOut" [静态] 定义 rollOut 事件对象的 type 属性值。 | MouseEvent | ||
ROLL_OVER : String = "rollOver" [静态] 定义 rollOver 事件对象的 type 属性值。 | MouseEvent | ||
SCROLL : String = "scroll" [静态] Event.SCROLL 常量定义 scroll 事件对象的 type 属性值。 | Event | ||
SELECT : String = "select" [静态] Event.SELECT 常量定义 select 事件对象的 type 属性的值。 | Event | ||
SELECT_ALL : String = "selectAll" [静态] Event.SELECT_ALL 常量定义 selectAll 事件对象的 type 属性的值。 | Event | ||
SOUND_COMPLETE : String = "soundComplete" [静态] Event.SOUND_COMPLETE 常量定义 soundComplete 事件对象的 type 属性值。 | Event | ||
TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [静态] Event.TAB_CHILDREN_CHANGE 常量定义 tabChildrenChange 事件对象的 type 属性值。 | Event | ||
TAB_ENABLED_CHANGE : String = "tabEnabledChange" [静态] Event.TAB_ENABLED_CHANGE 常量定义 tabEnabledChange 事件对象的 type 属性值。 | Event | ||
TAB_INDEX_CHANGE : String = "tabIndexChange" [静态] Event.TAB_INDEX_CHANGE 常量定义 tabIndexChange 事件对象的 type 属性值。 | Event | ||
UNLOAD : String = "unload" [静态] Event.UNLOAD 常量定义 unload 事件对象的 type 属性值。 | Event | ||
USER_IDLE : String = "userIdle" [静态] Event.USER_IDLE 常量定义 userIdle 事件对象的 type 属性值。 | Event | ||
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
clickCount | 属性 |
clickCount:int
[只读 (read-only)] 语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 |
指示鼠标按下事件是否为多击序列的一部分。对于除 MouseEvent.mouseDown
、MouseEvent.mouseUp
、MouseEvent.middleMouseDown
、MouseEvent.middleMouseUp
、MouseEvent.rightMouseDown
和 MouseEvent.rightMouseUp
以外的所有鼠标事件,此参数将为零。使用 clickCount
参数可以侦听单击、双击或任何多击序列。例如,初始 MouseEvent.mouseDown
和 MouseEvent.mouseUp
的 clickCount
为 1,双击序列中的第二个 MouseEvent.mouseDown
和 MouseEvent.mouseUp
的 clickCount
为 2。如果充分地移动鼠标或多击序列由于某种原因中断,则下一个 MouseEvent.mouseDown
的 clickCount 将为 1。doubleClick 事件将会继续正常触发。
public function get clickCount():int
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
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
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
relatedObject | 属性 |
relatedObject:InteractiveObject
[读写] 语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 Flash Player 9 |
对与事件相关的显示列表对象的引用。例如,发生 mouseOut
事件时,relatedObject
表示指针设备当前所指向的显示列表对象。此属性应用于 mouseOut
、mouseOver
、rollOut
和 rollOver
事件。
在以下两种情况下,此属性的值可以为 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
stageY | 属性 |
stageY:Number
[只读 (read-only)] 语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 Flash Player 9 |
事件发生点在全局舞台坐标中的垂直坐标。当设置 localY
属性时会计算此属性。
public function get stageY():Number
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.CLICK 、MouseEvent.DOUBLE_CLICK 、MouseEvent.MOUSE_DOWN 、MouseEvent.MOUSE_MOVE 、MouseEvent.MOUSE_OUT 、MouseEvent.MOUSE_OVER 、MouseEvent.MOUSE_UP 、MouseEvent.MIDDLE_CLICK 、MouseEvent.MIDDLE_MOUSE_DOWN 、MouseEvent.MIDDLE_MOUSE_UP 、MouseEvent.RIGHT_CLICK 、MouseEvent.RIGHT_MOUSE_DOWN 、MouseEvent.RIGHT_MOUSE_UP 、MouseEvent.MOUSE_WHEEL 、MouseEvent.ROLL_OUT 和 MouseEvent.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.click 、MouseEvent.mouseDown 、MouseEvent.mouseUp 、MouseEvent.middleClick 、MouseEvent.middleMouseDown 、MouseEvent.middleMouseUp 、MouseEvent.rightClick 、MouseEvent.rightMouseDown 、MouseEvent.rightMouseUp 和 MouseEvent.doubleClick 事件。
| |
controlKey:Boolean (default = false ) —
指示是否已激活 Control 或 Ctrl 键。此参数仅用于 MouseEvent.click 、MouseEvent.mouseDown 、MouseEvent.mouseUp 、MouseEvent.middleClick 、MouseEvent.middleMouseDown 、MouseEvent.middleMouseUp 、MouseEvent.rightClick 、MouseEvent.rightMouseDown 、MouseEvent.rightMouseUp 和 MouseEvent.doubleClick 事件。
| |
clickCount:int (default = 0 ) —
指示鼠标事件是否为多击序列的一部分。对于除 MouseEvent.mouseDown 、MouseEvent.mouseUp 、MouseEvent.middleMouseDown 、MouseEvent.middleMouseUp 、MouseEvent.rightMouseDown 和 MouseEvent.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 属性来访问显示列表中当前正在处理此事件的对象。
|
另请参见
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 属性来访问显示列表中当前正在处理此事件的对象。
|
另请参见
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 属性来访问显示列表中当前正在处理此事件的对象。
|
另请参见
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 属性来访问显示列表中当前正在处理此事件的对象。
|
另请参见
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 | 常量 |
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 属性来访问显示列表中当前正在处理此事件的对象。
|
另请参见
在构造函数中, 创建了一个矩形 innerRect
Sprite 对象并将线条样式设置为绿色。用于在 MouseEvent_MOUSE_MOVEExample
Sprite 容器上进行绘制的线条样式设置为红色。为应用程序的主 Sprite 对象和 innerRect
Sprite 对象添加侦听 MouseEvent.MOUSE_UP
和 MouseEvent.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_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 属性来访问显示列表中当前正在处理此事件的对象。
|
另请参见
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 属性来访问显示列表中当前正在处理此事件的对象。
|
另请参见
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 属性来访问显示列表中当前正在处理此事件的对象。
|
另请参见
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
和 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()
:当用户在正方形上方滚动鼠标滚轮时调度。
child
通过 addChild()
(立即绘制橙色正方形)添加到显示列表中。
注意:
MouseEventExample
类应为文档根。
sprite
,它用于 event.target
到类型 Sprite 的强制转换。
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); } }