| 包 | flash.display |
| 类 | public class InteractiveObject |
| 继承 | InteractiveObject DisplayObject EventDispatcher Object |
| 子类 | DisplayObjectContainer, SimpleButton, TextField |
| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
不能直接实例化 InteractiveObject 类。调用 new InteractiveObject() 构造函数会引发 ArgumentError 异常。
InteractiveObject 类本身不包含任何用于在屏幕上呈现内容的 API。鉴于此原因,如果要创建 InteractiveObject 类的一个自定义子类,您将需要扩展其中一个具有在屏幕上显示内容的 API 的子类,如 Sprite、SimpleButton、TextField 或 MovieClip 类。
另请参见
| 属性 | 定义方 | ||
|---|---|---|---|
![]() | accessibilityProperties : AccessibilityProperties 此显示对象的当前辅助功能选项。 | DisplayObject | |
![]() | alpha : Number 指示指定对象的 Alpha 透明度值。 | DisplayObject | |
![]() | blendMode : String BlendMode 类中的一个值,用于指定要使用的混合模式。 | DisplayObject | |
![]() | blendShader : Shader [只写] 设置用于混合前景和背景的着色器。 | DisplayObject | |
![]() | cacheAsBitmap : Boolean 如果设置为 true,则 Flash Player 或 Adobe AIR 将缓存显示对象的内部位图表示形式。 | DisplayObject | |
![]() | constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| contextMenu : NativeMenu 指定与此对象相关联的上下文菜单。 | InteractiveObject | ||
| doubleClickEnabled : Boolean 指定此对象是否接收 doubleClick 事件。 | InteractiveObject | ||
![]() | filters : Array 包含当前与显示对象关联的每个滤镜对象的索引数组。 | DisplayObject | |
| focusRect : Object 指定此对象是否显示焦点矩形。 | InteractiveObject | ||
![]() | height : Number 指示显示对象的高度,以像素为单位。 | DisplayObject | |
![]() | loaderInfo : LoaderInfo [只读 (read-only)] 返回一个 LoaderInfo 对象,其中包含加载此显示对象所属的文件的相关信息。 | DisplayObject | |
![]() | mask : DisplayObject 调用显示对象被指定的 mask 对象遮罩。 | DisplayObject | |
| mouseEnabled : Boolean 指定此对象是否接收鼠标消息。 | InteractiveObject | ||
![]() | mouseX : Number [只读 (read-only)] 指示鼠标位置的 x 坐标,以像素为单位。 | DisplayObject | |
![]() | mouseY : Number [只读 (read-only)] 指示鼠标位置的 y 坐标,以像素为单位。 | DisplayObject | |
![]() | name : String 指示 DisplayObject 的实例名称。 | DisplayObject | |
![]() | opaqueBackground : Object 指定显示对象是否由于具有某种背景颜色而不透明。 | DisplayObject | |
![]() | parent : DisplayObjectContainer [只读 (read-only)] 指示包含此显示对象的 DisplayObjectContainer 对象。 | DisplayObject | |
![]() | prototype : Object [静态]
对类或函数对象的原型对象的引用。 | Object | |
![]() | root : DisplayObject [只读 (read-only)] 对于加载的 SWF 文件中的显示对象,root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。 | DisplayObject | |
![]() | rotation : Number 指示 DisplayObject 实例距其原始方向的旋转程度,以度为单位。 | DisplayObject | |
![]() | rotationX : Number 指示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 x 轴旋转(以度为单位)。 | DisplayObject | |
![]() | rotationY : Number 指示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 y 轴旋转(以度为单位)。 | DisplayObject | |
![]() | rotationZ : Number 指示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 z 轴旋转(以度为单位)。 | DisplayObject | |
![]() | scale9Grid : Rectangle 当前有效的缩放网格。 | DisplayObject | |
![]() | scaleX : Number 指示从注册点开始应用的对象的水平缩放比例(百分比)。 | DisplayObject | |
![]() | scaleY : Number 指示从对象注册点开始应用的对象的垂直缩放比例(百分比)。 | DisplayObject | |
![]() | scaleZ : Number 指示从对象的注册点开始应用的对象的深度缩放比例(百分比)。 | DisplayObject | |
![]() | scrollRect : Rectangle 显示对象的滚动矩形范围。 | DisplayObject | |
![]() | stage : Stage [只读 (read-only)] 显示对象的舞台。 | DisplayObject | |
| tabEnabled : Boolean 指定此对象是否遵循 Tab 键顺序。 | InteractiveObject | ||
| tabIndex : int 指定 SWF 文件中的对象按 Tab 键顺序排列。 | InteractiveObject | ||
![]() | transform : Transform 一个对象,具有与显示对象的矩阵、颜色转换和像素范围有关的属性。 | DisplayObject | |
![]() | visible : Boolean 显示对象是否可见。 | DisplayObject | |
![]() | width : Number 指示显示对象的宽度,以像素为单位。 | DisplayObject | |
![]() | x : Number 指示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 x 坐标。 | DisplayObject | |
![]() | y : Number 指示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 y 坐标。 | DisplayObject | |
![]() | z : Number 指示 DisplayObject 实例相对于 3D 父容器沿 z 轴的 z 坐标位置。 | DisplayObject | |
| 方法 | 定义方 | ||
|---|---|---|---|
调用新的 InteractiveObject() 构造函数会引发 ArgumentError 异常。 | InteractiveObject | ||
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。 | EventDispatcher | |
![]() | 将事件调度到事件流中。 | EventDispatcher | |
![]() | 返回一个矩形,该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。 | DisplayObject | |
![]() | 返回一个矩形,该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界,但不包括形状上的任何笔触。 | DisplayObject | |
![]() | 将 point 对象从舞台(全局)坐标转换为显示对象的(本地)坐标。 | DisplayObject | |
![]() | 将二维点从舞台(全局)坐标转换为三维显示对象的(本地)坐标。 | DisplayObject | |
![]() | 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | |
![]() |
指示对象是否已经定义了指定的属性。 | Object | |
![]() | 计算显示对象,以确定它是否与 obj 显示对象重叠或相交。 | DisplayObject | |
![]() | 计算显示对象,以确定它是否与 x 和 y 参数指定的点重叠或相交。 | DisplayObject | |
![]() |
指示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
![]() | 将三维显示对象的(本地)坐标的三维点转换为舞台(全局)坐标中的二维点。 | DisplayObject | |
![]() | 将 point 对象从显示对象的(本地)坐标转换为舞台(全局)坐标。 | DisplayObject | |
![]() |
指示指定的属性是否存在、是否可枚举。 | Object | |
![]() | 从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | |
![]() |
设置循环操作动态属性的可用性。 | Object | |
![]() |
返回指定对象的字符串表示形式。 | Object | |
![]() |
返回指定对象的原始值。 | Object | |
![]() | 检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。 | EventDispatcher | |
| 事件 | 摘要 | 定义方 | ||
|---|---|---|---|---|
![]() | [广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。 | EventDispatcher | ||
![]() | 将显示对象添加到显示列表中时调度。 | DisplayObject | ||
![]() | 在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。 | DisplayObject | ||
| 当用户从文本上下文菜单中选择“清除”(或“删除”)时调度。 | InteractiveObject | |||
| 用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。 | InteractiveObject | |||
| 当用户在 AIR 应用程序中选择与此交互式对象相关联的上下文菜单时调度。 | InteractiveObject | |||
| 当用户激活特定于平台的复制操作的快捷键组合或从文本上下文菜单中选择“复制”时调度。 | InteractiveObject | |||
| 当用户激活特定于平台的剪切操作的快捷键组合或从文本上下文菜单中选择“剪切”时调度。 | InteractiveObject | |||
![]() | [广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。 | EventDispatcher | ||
| 如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true,当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。 | InteractiveObject | |||
![]() | [播放事件] 播放头进入新帧时调度。 | DisplayObject | ||
![]() | [广播事件] 播放头退出当前帧时调度。 | DisplayObject | ||
| 显示对象获得焦点后调度。 | InteractiveObject | |||
| 显示对象失去焦点后调度。 | InteractiveObject | |||
![]() | [广播事件] 在帧显示对象的构造函数运行之后但在帧脚本运行之前调度。 | DisplayObject | ||
| 用户按下某个键时调度。 | InteractiveObject | |||
| 用户尝试使用键盘导航更改焦点时调度。 | InteractiveObject | |||
| 用户释放某个键时调度。 | InteractiveObject | |||
| 当用户在同一 InteractiveObject 上按下并释放用户指针设备的中间按钮时调度。 | InteractiveObject | |||
| 当用户在 InteractiveObject 实例上按下指针设备的中间按钮时调度。 | InteractiveObject | |||
| 当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 | InteractiveObject | |||
| 当用户在 InteractiveObject 实例上按下指针设备按钮时调度。 | InteractiveObject | |||
| 用户尝试使用指针设备更改焦点时调度。 | InteractiveObject | |||
| 用户移动 InteractiveObject 上的指针设备时调度。 | InteractiveObject | |||
| 用户将指针设备从 InteractiveObject 实例上移开时调度。 | InteractiveObject | |||
| 用户将指针设备移动到 InteractiveObject 实例上时调度。 | InteractiveObject | |||
| 当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 | InteractiveObject | |||
| 当鼠标滚轮滚动到 InteractiveObject 实例上时调度。 | InteractiveObject | |||
| 当用户释放拖动动作时由拖动启动器 InteractiveObject 调度。 | InteractiveObject | |||
| 在将拖动对象放置到目标上且已通过对 DragManager.acceptDragDrop() 的调用接受该放置操作时,由目标 InteractiveObject 调度。 | InteractiveObject | |||
| 当拖动动作进入其边界时由 InteractiveObject 调度。 | InteractiveObject | |||
| 当拖动动作离开其边界时由 InteractiveObject 调度。 | InteractiveObject | |||
| 当拖动动作保持在其边界内时,由 InteractiveObject 持续调度。 | InteractiveObject | |||
| 在拖动操作开始时由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。 | InteractiveObject | |||
| 在拖动操作期间由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。 | InteractiveObject | |||
| 当用户激活特定于平台的粘贴操作的快捷键组合或从文本上下文菜单中选择“粘贴”时调度。 | InteractiveObject | |||
![]() | 将要从显示列表中删除显示对象时调度。 | DisplayObject | ||
![]() | 在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。 | DisplayObject | ||
![]() | [广播事件] 将要更新和呈现显示列表时调度。 | DisplayObject | ||
| 当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。 | InteractiveObject | |||
| 当用户在 InteractiveObject 实例上按下指针设备按钮时调度。 | InteractiveObject | |||
| 当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 | InteractiveObject | |||
| 用户将指针设备从 InteractiveObject 实例上移开时调度。 | InteractiveObject | |||
| 用户将指针设备移动到 InteractiveObject 实例上时调度。 | InteractiveObject | |||
| 当用户激活特定于平台的全选操作的快捷键组合或从文本上下文菜单中选择“全选”时调度。 | InteractiveObject | |||
| 对象的 tabChildren 标志值发生更改时调度。 | InteractiveObject | |||
| 对象的 tabEnabled 标志发生更改时调度。 | InteractiveObject | |||
| 对象的 tabIndex 属性值发生更改时调度。 | InteractiveObject | |||
| contextMenu | 属性 |
contextMenu:NativeMenu [读写] | 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
指定与此对象相关联的上下文菜单。
对于在 Flash Player 中运行的内容,此属性是一个 ContextMenu 对象。在 AIR 运行时中,ContextMenu 类扩展 NativeMenu 类,但 Flash Player 只支持 ContextMenu 类,不支持 NativeMenu 类。
public function get contextMenu():NativeMenu public function set contextMenu(value:NativeMenu):void| doubleClickEnabled | 属性 |
doubleClickEnabled:Boolean [读写] | 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
指定此对象是否接收 doubleClick 事件。默认值为 false,这意味着在默认情况下,InteractiveObject 实例不接收 doubleClick 事件。如果将 doubleClickEnabled 属性设置为 true,实例在其范围内接收 doubleClick 事件。InteractiveObject 实例的 mouseEnabled 属性也必须设置为 true,以便对象能够接收 doubleClick 事件。
设置此属性不会调度任何事件。必须使用 addEventListener() 方法为 doubleClick 事件添加事件侦听器。
public function get doubleClickEnabled():Boolean public function set doubleClickEnabled(value:Boolean):void另请参见
| focusRect | 属性 |
focusRect:Object [读写] | 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
指定此对象是否显示焦点矩形。它可以采用三个值中的一个:true、false 或 null。true 和 false 值按预期工作,指定是否显示焦点矩形。null 值指示此对象遵循舞台的 stageFocusRect 属性。
public function get focusRect():Object public function set focusRect(value:Object):void| mouseEnabled | 属性 |
mouseEnabled:Boolean [读写] | 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
指定此对象是否接收鼠标消息。默认值为 true,这意味着在默认情况下,显示列表上的任何 InteractiveObject 实例均接收鼠标事件。如果将 mouseEnabled 设置为 false,实例不接收任何鼠标事件。显示列表上的该实例的任何子级都不会受到影响。要更改显示列表上对象的所有子级的 mouseEnabled 行为,请使用 flash.display.DisplayObjectContainer.mouseChildren。
设置此属性不会调度任何事件。您必须使用 addEventListener() 方法才能创建交互式功能。
public function get mouseEnabled():Boolean public function set mouseEnabled(value:Boolean):void另请参见
| tabEnabled | 属性 |
tabEnabled:Boolean [读写] | 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
指定此对象是否遵循 Tab 键顺序。如果该对象遵循 Tab 键顺序,值为 true;否则值为 false。默认情况下,值为 false,但以下情况除外:
true。
type = "input" 的 TextField 对象,值为 true。
buttonMode = true 的 Sprite 对象或 MovieClip 对象,值为 true。
public function get tabEnabled():Boolean public function set tabEnabled(value:Boolean):void| tabIndex | 属性 |
tabIndex:int [读写] | 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
指定 SWF 文件中的对象按 Tab 键顺序排列。默认情况下,tabIndex 属性为 -1,这意味着没有为该对象设置任何 Tab 索引。
如果 SWF 文件中当前显示的任何对象包含 tabIndex 属性,则禁用 Tab 键自动排序,而使用该 SWF 文件中对象的 tabIndex 属性来计算 Tab 键顺序。这个自定义的 Tab 键排序仅包括指定了 tabIndex 属性的对象。
tabIndex 属性可以是非负整数。这些对象按照其 tabIndex 属性按升序进行排序。tabIndex 值为 1 的对象在 tabIndex 值为 2 的对象的前面。不要对多个对象使用相同的 tabIndex 值。
由 tabIndex 属性定义的自定义 Tab 键顺序为平构。这意味着不考虑 SWF 文件中对象的层次结构关系。SWF 文件中具有 tabIndex 属性的所有对象都排入 Tab 键顺序中,而 Tab 键顺序由 tabIndex 值的顺序确定。
public function get tabIndex():int public function set tabIndex(value:int):void| InteractiveObject | () | 构造函数 |
public function InteractiveObject()| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
调用 new InteractiveObject() 构造函数会引发 ArgumentError 异常。但是,可以调用以下 InteractiveObject 的子类的构造函数:
new SimpleButton()
new TextField()
new Loader()
new Sprite()
new MovieClip()
| clear | 事件 |
flash.events.Eventflash.events.Event.CLEAR| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
当用户从文本上下文菜单中选择“清除”(或“删除”)时调度。将此事件调度到当前具有焦点的对象。如果当前具有焦点的对象是一个 TextField,则此事件的默认行为是删除该文本字段中当前选定的所有文本。
Event.CLEAR 常量定义 clear 事件对象的 type 属性的值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles
|
false
|
cancelable
|
false;没有要取消的默认行为。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target
|
具有为 clear 事件注册的侦听器的任何 InteractiveObject 实例。
|
| click | 事件 |
flash.events.MouseEventflash.events.MouseEvent.CLICK| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。要使单击事件发生,它必须始终在以下顺序的一系列事件后面:mouseDown 事件,然后是 mouseUp 事件。这两个事件的目标对象必须相同,否则不会发生 click 事件。mouseDown 或 mouseUp 事件之间的任何时间会发生任何数量的其它鼠标事件;click 事件仍会发生。
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 属性来访问显示列表中当前正在处理此事件的对象。
|
| 事件 |
flash.events.MouseEventflash.events.MouseEvent.CONTEXT_MENU| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 |
当用户在 AIR 应用程序中选择与此交互式对象相关联的上下文菜单时调度。
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 属性来访问显示列表中当前正在处理此事件的对象。
|
另请参见
| copy | 事件 |
flash.events.Eventflash.events.Event.COPY| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
当用户激活特定于平台的复制操作的快捷键组合或从文本上下文菜单中选择“复制”时调度。将此事件调度到当前具有焦点的对象。如果当前具有焦点的对象是一个 TextField,则此事件的默认行为是将该文本字段中当前选定的所有文本复制到剪贴板。
定义copy 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles
|
false
|
cancelable
|
false;没有要取消的默认行为。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target
|
具有为 copy 事件注册的侦听器的任何 InteractiveObject 实例。
|
| cut | 事件 |
flash.events.Eventflash.events.Event.CUT| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
当用户激活特定于平台的剪切操作的快捷键组合或从文本上下文菜单中选择“剪切”时调度。将此事件调度到当前具有焦点的对象。如果当前具有焦点的对象是一个 TextField,则此事件的默认行为是将该文本字段中当前选定的所有文本剪切到剪贴板。
定义cut 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles
|
false
|
cancelable
|
false;没有要取消的默认行为。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target
|
具有为 cut 事件注册的侦听器的任何 InteractiveObject 实例。
|
| doubleClick | 事件 |
flash.events.MouseEventflash.events.MouseEvent.DOUBLE_CLICK| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true,当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。要使 doubleClick 事件发生,它必在以下一系列事件后面:mouseDown、mouseUp、click、mouseDown、mouseUp。所有这些事件必须共享与 doubleClick 事件相同的目标。第二个 mouseDown 和 mouseUp 事件代表第二次单击,该行为必须在 click 事件之后的指定时间段内发生。该时间段的允许长度因操作系统而异,而且通常可由用户配置。如果目标为可选文本字段,作为默认行为,会选择指针下面的单词。如果目标 InteractiveObject 未将其 doubleClickEnabled 标志设置为 true,它将接收两个 click 事件。
doubleClickEnabled 属性默认为 false。
TextField 对象的双击文本选择行为与 doubleClick 事件无关。使用 TextField.doubleClickEnabled 控制 TextField 选择。
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 属性来访问显示列表中当前正在处理此事件的对象。
|
另请参见
| focusIn | 事件 |
flash.events.FocusEventflash.events.FocusEvent.FOCUS_IN| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
显示对象获得焦点后调度。这种情况会在用户使用指针设备或键盘导航加亮显示对象时发生。该焦点的接收方称为该事件的目标对象,而因该更改而失去焦点的相应 InteractiveObject 实例称为相关对象。对相关对象的引用存储在接收对象的 relatedObject 属性中。未使用 shiftKey 属性。在该事件在调度前一个对象的 focusOut 事件之后发生。
focusIn 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles
|
true
|
cancelable
|
false;没有要取消的默认行为。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
keyCode
|
0;仅应用于 keyFocusChange 事件。
|
relatedObject
| 受焦点更改影响的补充 InteractiveObject 实例。 |
shiftKey
|
false;仅应用于 keyFocusChange 事件。
|
target
|
刚刚获得焦点的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。
|
direction
|
焦点的分配方向。此属性报告舞台的 assignFocus() 方法的 direction 参数。如果通过其他方式更改焦点,则该值将始终为 FocusDirection.NONE。仅适用于 focusIn 事件。对于所有其他焦点事件,该值将为 FocusDirection.NONE。
|
| focusOut | 事件 |
flash.events.FocusEventflash.events.FocusEvent.FOCUS_OUT| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
显示对象失去焦点后调度。这种情况会在用户使用指针设备或键盘导航加亮显示不同的对象时发生。失去焦点的对象称为该事件的目标对象,而接收焦点的相应 InteractiveObject 实例称为相关对象。对相关对象的引用存储在目标对象的 relatedObject 属性中。未使用 shiftKey 属性。该事件在相关对象调度 focusIn 事件之前发生。
focusOut 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles
|
true
|
cancelable
|
false;没有要取消的默认行为。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
keyCode
|
0;仅应用于 keyFocusChange 事件。
|
relatedObject
| 受焦点更改影响的补充 InteractiveObject 实例。 |
shiftKey
|
false;仅应用于 keyFocusChange 事件。
|
target
|
刚刚失去焦点的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。
|
| keyDown | 事件 |
flash.events.KeyboardEventflash.events.KeyboardEvent.KEY_DOWN| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
用户按下某个键时调度。按键与特定字符之间的映射因设备和操作系统而异。此事件类型是在此类映射发生之后、输入法编辑器 (IME) 处理之前生成的。IME 用于输入标准 QWERTY 键盘无法生成的字符(如中国象形文字)。该事件在 keyUp 事件之前发生。
keyDown 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles
|
true
|
cancelable
|
false;没有要取消的默认行为。
|
charCode
| 按下或释放的键的字符代码值。 |
commandKey
|
在 Mac 中,如果 Command 键处于活动状态,则为 true。否则为 false
|
controlKey
|
在 Windows 和 Linux 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Control 键处于活动状态,则为 true。否则为 false
|
ctrlKey
|
在 Windows 和 Linux 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 true。否则为 false。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
keyCode
| 按下或释放的键的键控代码值。 |
keyLocation
| 按键在键盘上的位置。 |
shiftKey
|
如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false。
|
target
|
具有焦点的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。
|
另请参见
| keyFocusChange | 事件 |
flash.events.FocusEventflash.events.FocusEvent.KEY_FOCUS_CHANGE| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
用户尝试使用键盘导航更改焦点时调度。此事件的默认行为是更改焦点并调度相应的 focusIn 和 focusOut 事件。
将此事件调度到当前具有焦点的对象。如果您没有禁止默认行为,则此事件的相关对象为接收焦点的 InteractiveObject 实例。可以通过调用正确注册到目标对象的事件侦听器中的 preventDefault() 方法来防止更改焦点。默认情况下调度焦点更改和 focusIn 及 focusOut 事件。
keyFocusChange 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles
|
true
|
cancelable
|
true;调用 preventDefault() 方法以取消默认行为。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
keyCode
|
被按下以触发 keyFocusChange 事件的键的键控代码值。
|
relatedObject
| 受焦点更改影响的补充 InteractiveObject 实例。 |
shiftKey
|
如果 Shift 功能键处于激活状态,则为 true;否则为 false。
|
target
|
当前具有焦点的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。
|
| keyUp | 事件 |
flash.events.KeyboardEventflash.events.KeyboardEvent.KEY_UP| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
用户释放某个键时调度。按键与特定字符之间的映射因设备和操作系统而异。此事件类型是在此类映射发生之后、输入法编辑器 (IME) 处理之前生成的。IME 用于输入标准 QWERTY 键盘无法生成的字符(如中国象形文字)。该事件在 keyDown 事件之后发生,并具备以下特征:
keyUp 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles
|
true
|
cancelable
|
false;没有要取消的默认行为。
|
charCode
| 包含按下或释放的键的字符代码值。 |
commandKey
|
在 Mac 中,如果 Command 键处于活动状态,则为 true。否则为 false
|
controlKey
|
在 Windows 和 Linux 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Control 键处于活动状态,则为 true。否则为 false
|
ctrlKey
|
在 Windows 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 true。否则为 false。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
keyCode
| 按下或释放的键的键控代码值。 |
keyLocation
| 按键在键盘上的位置。 |
shiftKey
|
如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false。
|
target
|
具有焦点的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。
|
| 事件 |
flash.events.MouseEventflash.events.MouseEvent.MIDDLE_CLICK| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 |
当用户在同一 InteractiveObject 上按下并释放用户指针设备的中间按钮时调度。要使 middleClick 事件发生,该事件必须始终按照发生顺序跟在以下一系列事件之后:middleMouseDown 事件,然后是 middleMouseUp。这两个事件的目标对象必须相同,否则不会发生 middleClick 事件。在 middleMouseDown 或 middleMouseUp 事件之间可以随时发生任意数量的其他鼠标事件;middleClick 事件仍会发生。
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 属性来访问显示列表中当前正在处理此事件的对象。
|
| 事件 |
flash.events.MouseEventflash.events.MouseEvent.MIDDLE_MOUSE_DOWN| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 |
当用户在 InteractiveObject 实例上按下指针设备的中间按钮时调度。
定义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 属性来访问显示列表中当前正在处理此事件的对象。
|
| 事件 |
flash.events.MouseEventflash.events.MouseEvent.MIDDLE_MOUSE_UP| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 |
当用户在 InteractiveObject 实例上释放指针设备按钮时调度。
定义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 属性来访问显示列表中当前正在处理此事件的对象。
|
| mouseDown | 事件 |
flash.events.MouseEventflash.events.MouseEvent.MOUSE_DOWN| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
当用户在 InteractiveObject 实例上按下指针设备按钮时调度。如果目标为 SimpleButton 实例,作为默认行为,SimpleButton 实例会显示 downState 显示对象。如果目标为可选文本字段,作为默认行为,该文本字段会开始选择。
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 属性来访问显示列表中当前正在处理此事件的对象。
|
| mouseFocusChange | 事件 |
flash.events.FocusEventflash.events.FocusEvent.MOUSE_FOCUS_CHANGE| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
用户尝试使用指针设备更改焦点时调度。此事件的默认行为是更改焦点并调度相应的 focusIn 和 focusOut 事件。
将此事件调度到当前具有焦点的对象。如果您没有禁止默认行为,则此事件的相关对象为接收焦点的 InteractiveObject 实例。可以通过调用正确注册到目标对象的事件侦听器中的 preventDefault() 来防止更改焦点。未使用 shiftKey 属性。默认情况下调度焦点更改和 focusIn 及 focusOut 事件。
mouseFocusChange 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles
|
true
|
cancelable
|
true;调用 preventDefault() 方法以取消默认行为。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
keyCode
|
0;仅应用于 keyFocusChange 事件。
|
relatedObject
| 受焦点更改影响的补充 InteractiveObject 实例。 |
shiftKey
|
false;仅应用于 keyFocusChange 事件。
|
target
|
当前具有焦点的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。
|
| mouseMove | 事件 |
flash.events.MouseEventflash.events.MouseEvent.MOUSE_MOVE| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
用户移动 InteractiveObject 上的指针设备时调度。如果目标为用户正在选择的文本字段,则作为默认行为,会更新选择。
定义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 属性来访问显示列表中当前正在处理此事件的对象。
|
| mouseOut | 事件 |
flash.events.MouseEventflash.events.MouseEvent.MOUSE_OUT| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
用户将指针设备从 InteractiveObject 实例上移开时调度。事件目标是指先前在指针设备下的对象。relatedObject 是将指针设备向其移动的对象。如果目标为 SimpleButton 实例,作为默认行为,该按钮会显示 upState 显示对象。
每次鼠标离开显示对象容器的任何子对象区域时都会调度 mouseOut 事件,即使鼠标停留在显示对象容器的另一个子对象上也是如此。此行为不同于 rollOut 事件的用途,此事件用于简化带有子级的显示对象容器的滑过行为的编码。当鼠标离开某个显示对象区域或任何其子级区域以转到其子级以外的对象时,该显示对象将调度 rollOut 事件。rollOut 事件是沿该对象的父级链向上连续调度的,从该对象开始,并以 relatedObject 的根或始祖之外的最高父级结束。
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 属性来访问显示列表中当前正在处理此事件的对象。
|
| mouseOver | 事件 |
flash.events.MouseEventflash.events.MouseEvent.MOUSE_OVER| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
用户将指针设备移动到 InteractiveObject 实例上时调度。relatedObject 是以前在指针设备下的对象。如果目标为 SimpleButton 实例,作为默认行为,该对象会根据是否按下鼠标按键而显示 overState 或 upState 显示对象。
每次鼠标进入显示对象容器的任何子对象区域时都会调度 mouseOver 事件,即使鼠标已在显示对象容器的另一个子对象上也是如此。此行为不同于 rollOver 事件的用途,此事件用于简化带有子级的显示对象容器的移出行为的编码。当鼠标进入某个显示对象区域或者从其子级以外的对象进入任何其子级区域时,该显示对象将调度 rollOver 事件。rollOver 事件是沿该对象的父级链向下连续调度的,从 relatedObject 的根或始祖之外的最高父级开始,并以该对象结束。
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 属性来访问显示列表中当前正在处理此事件的对象。
|
| mouseUp | 事件 |
flash.events.MouseEventflash.events.MouseEvent.MOUSE_UP| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
当用户在 InteractiveObject 实例上释放指针设备按钮时调度。如果目标为 SimpleButton 实例,该对象会显示 upState 显示对象。如果目标为可选文本字段,则作为默认行为,该文本字段会结束选择。
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 属性来访问显示列表中当前正在处理此事件的对象。
|
| mouseWheel | 事件 |
flash.events.MouseEventflash.events.MouseEvent.MOUSE_WHEEL| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
当鼠标滚轮滚动到 InteractiveObject 实例上时调度。如果目标为文本字段,则作为默认行为,该文本会滚动。
定义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 属性来访问显示列表中当前正在处理此事件的对象。
|
| 事件 |
flash.events.NativeDragEventflash.events.NativeDragEvent.NATIVE_DRAG_COMPLETE| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 |
当用户释放拖动动作时由拖动启动器 InteractiveObject 调度。
该事件的 dropAction 属性指示由拖动目标对象设置的动作;“none”值 (DragActions.NONE) 指示放置动作被取消或未被接受。
nativeDragComplete 事件处理函数是更新启动显示对象的方便场所,例如,通过从列表中删除一个项目(针对“move”的拖动动作),或通过更改可视属性。
nativeDragComplete 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
allowedActions
| 指定与此拖动操作相关的动作的 NativeDragOptions 对象。 |
bubbles
|
false
|
cancelable
|
false;没有要取消的默认行为。
|
clipboard
| 包含拖动数据的 Clipboard 对象。 |
dropAction
|
由放置目标选择的动作(或在未设置任何动作时为 none)。
|
| 事件 |
flash.events.NativeDragEventflash.events.NativeDragEvent.NATIVE_DRAG_DROP| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 |
在将拖动对象放置到目标上且已通过对 DragManager.acceptDragDrop() 的调用接受该放置操作时,由目标 InteractiveObject 调度。
使用事件对象的 clipboard 属性访问放置的数据。
此事件的处理函数应该设置 DragManager.dropAction 属性以向启动器提供有关采取了哪种拖动动作的反馈。如果未设置任何值,DragManager 将从允许动作的列表中选择一个默认值。
nativeDragDrop 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
allowedActions
| 指定与此拖动操作相关的动作的 NativeDragOptions 对象。 |
bubbles
|
false
|
cancelable
|
true;取消此事件会取消拖动操作。
|
clipboard
| 包含拖动数据的 Clipboard 对象。即使在调度此事件的对象与启动器不在同一安全域中时也可以读取剪贴板。 |
dropAction
|
由放置目标选择的动作(或在未设置任何动作时为 none)。
|
| 事件 |
flash.events.NativeDragEventflash.events.NativeDragEvent.NATIVE_DRAG_ENTER| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 |
当拖动动作进入其边界时由 InteractiveObject 调度。
处理 nativeDragEnter 或 nativeDragOver 事件以允许显示对象成为放置目标。
若要确定执行调度的显示对象是否能接受放置,请检查该事件对象的 clipboard 属性中数据的适用性,并检查 allowedActions 属性中允许的拖动动作。
nativeDragEnter 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
allowedActions
| 指定与此拖动操作相关的动作的 NativeDragOptions 对象。 |
bubbles
|
false
|
cancelable
|
false;没有要取消的默认行为。
|
clipboard
| 包含拖动数据的 Clipboard 对象。只有当调度此事件的对象与启动器位于同一安全域中时才能读取剪贴板。 |
dropAction
|
由放置目标选择的动作(或在未设置任何动作时为 none)。
|
| 事件 |
flash.events.NativeDragEventflash.events.NativeDragEvent.NATIVE_DRAG_EXIT| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 |
当拖动动作离开其边界时由 InteractiveObject 调度。
NativeDragEvent.NATIVE_DRAG_EXIT 定义nativeDragExit 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
allowedActions
| 指定与此拖动操作相关的动作的 NativeDragOptions 对象。 |
bubbles
|
false
|
cancelable
|
false;没有要取消的默认行为。
|
clipboard
| 包含拖动数据的 Clipboard 对象。只有当调度此事件的对象与启动器位于同一安全域中时才能读取剪贴板。 |
dropAction
|
由放置目标选择的动作(或在未设置任何动作时为 none)。
|
| 事件 |
flash.events.NativeDragEventflash.events.NativeDragEvent.NATIVE_DRAG_OVER| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 |
当拖动动作保持在其边界内时,由 InteractiveObject 持续调度。
鼠标只要移动,就会调度 nativeDragOver 事件。在 Windows 和 Mac 中,即使不移动鼠标,每隔一小段时间也会调度这些事件。
处理 nativeDragOver 或 nativeDragEnter 事件以允许显示对象成为放置目标。
若要确定执行调度的显示对象是否能接受放置,请检查该事件对象的 clipboard 属性中数据的适用性,并检查 allowedActions 属性中允许的拖动动作。
nativeDragOver 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
allowedActions
| 指定与此拖动操作相关的动作的 NativeDragOptions 对象。 |
bubbles
|
false
|
cancelable
|
true;取消此事件会取消拖动操作。
|
clipboard
| 包含拖动数据的 Clipboard 对象。只有当调度此事件的对象与启动器位于同一安全域中时才能读取剪贴板。 |
dropAction
|
由放置目标选择的动作(或在未设置任何动作时为 none)。
|
| 事件 |
flash.events.NativeDragEventflash.events.NativeDragEvent.NATIVE_DRAG_START| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 |
在拖动操作开始时由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。
NativeDragEvent.NATIVE_DRAG_START 定义nativeDragStart 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
allowedActions
| 指定与此拖动操作相关的动作的 NativeDragOptions 对象。 |
bubbles
|
false
|
cancelable
|
true;取消此事件会取消拖动操作。
|
clipboard
| 包含拖动数据的 Clipboard 对象。 |
dropAction
|
由放置目标选择的动作(或在未设置任何动作时为 none)。
|
| 事件 |
flash.events.NativeDragEventflash.events.NativeDragEvent.NATIVE_DRAG_UPDATE| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 |
在拖动操作期间由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。
Linux 中不调度 nativeDragUpdate 事件。
nativeDragUpdate 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
allowedActions
| 指定与此拖动操作相关的动作的 NativeDragOptions 对象。 |
bubbles
|
false
|
cancelable
|
false;没有要取消的默认行为。
|
clipboard
| 包含拖动数据的 Clipboard 对象。 |
dropAction
|
由放置目标选择的动作(或在未设置任何动作时为 none)。
|
| paste | 事件 |
flash.events.Eventflash.events.Event.PASTE| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
当用户激活特定于平台的粘贴操作的快捷键组合或从文本上下文菜单中选择“粘贴”时调度。将此事件调度到当前具有焦点的对象。如果当前具有焦点的对象是一个 TextField,则此事件的默认行为是将剪贴板的所有内容粘贴到该文本字段的当前插入点,替换文本字段中当前选定的所有文本。
Event.PASTE 常量定义 paste 事件对象的 type 属性的值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles
|
false
|
cancelable
|
false;没有要取消的默认行为。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target
|
具有为 paste 事件注册的侦听器的任何 InteractiveObject 实例。
|
| 事件 |
flash.events.MouseEventflash.events.MouseEvent.RIGHT_CLICK| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 |
当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。要使 rightClick 事件发生,该事件必须始终按照发生顺序跟在以下一系列事件之后:rightMouseDown 事件,然后是 rightMouseUp。这两个事件的目标对象必须相同,否则不会发生 rightClick 事件。在 rightMouseDown 或 rightMouseUp 事件之间可以随时发生任意数量的其他鼠标事件;rightClick 事件仍会发生。
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 属性来访问显示列表中当前正在处理此事件的对象。
|
| 事件 |
flash.events.MouseEventflash.events.MouseEvent.RIGHT_MOUSE_DOWN| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 |
当用户在 InteractiveObject 实例上按下指针设备按钮时调度。
定义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 属性来访问显示列表中当前正在处理此事件的对象。
|
| 事件 |
flash.events.MouseEventflash.events.MouseEvent.RIGHT_MOUSE_UP| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 |
当用户在 InteractiveObject 实例上释放指针设备按钮时调度。
定义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 属性来访问显示列表中当前正在处理此事件的对象。
|
| rollOut | 事件 |
flash.events.MouseEventflash.events.MouseEvent.ROLL_OUT| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
用户将指针设备从 InteractiveObject 实例上移开时调度。事件目标是指先前在指针设备下的对象或该对象的父级。relatedObject 是将指针设备向其移动的对象。在该对象的父级链以上连续调度 rollOut 事件,以该对象为开头,并以除 relatedObject 的根或始祖之外的最高级别的父级结束。
rollOut 事件的目的是简化带有子级的显示对象容器的移开行为的编码。当鼠标离开显示对象区域或任何其子级区域并转到除其子级以外的对象时,显示对象调度 rollOut 事件。这是与 mouseOut 事件行为不同的行为,因为该事件是在每次鼠标离开显示对象容器的任何子对象区域时才会被调度,即使鼠标仍保留在显示对象容器的另一个子对象上也是如此。
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 属性来访问显示列表中当前正在处理此事件的对象。
|
| rollOver | 事件 |
flash.events.MouseEventflash.events.MouseEvent.ROLL_OVER| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
用户将指针设备移动到 InteractiveObject 实例上时调度。事件目标为指针设备下的对象或该对象的父级。relatedObject 是以前在指针设备下的对象。在该对象的父级链以下连续调度 rollOver 事件,以除 relatedObject 的根或始祖之外的最高级别的父级开头,并以该对象结束。
rollOver 事件的目的是简化带有子级的显示对象容器的移开行为的编码。当鼠标进入某个显示对象区域或者从其子级以外的对象进入任何其子级区域时,该显示对象将调度 rollOver 事件。这种行为与 mouseOver 事件的行为不同,每次鼠标进入显示对象容器的任何子对象区域时都会调度此事件,即使鼠标已在显示对象容器的另一个子对象上也是如此。
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 属性来访问显示列表中当前正在处理此事件的对象。
|
| selectAll | 事件 |
flash.events.Eventflash.events.Event.SELECT_ALL| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
当用户激活特定于平台的全选操作的快捷键组合或从文本上下文菜单中选择“全选”时调度。将此事件调度到当前具有焦点的对象。如果当前具有焦点的对象是一个 TextField,则此事件的默认行为是使该文本字段的所有内容处于选定状态。
Event.SELECT_ALL 常量定义 selectAll 事件对象的 type 属性的值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles
|
false
|
cancelable
|
false;没有要取消的默认行为。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target
|
具有为 selectAll 事件注册的侦听器的任何 InteractiveObject 实例。
|
| tabChildrenChange | 事件 |
flash.events.Eventflash.events.Event.TAB_CHILDREN_CHANGE| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
对象的 tabChildren 标志值发生更改时调度。
Event.TAB_CHILDREN_CHANGE 常量定义 tabChildrenChange 事件对象的 type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles
|
true
|
cancelable
|
false;没有要取消的默认行为。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target
|
其 tabChildren 标志已更改的对象。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。
|
| tabEnabledChange | 事件 |
flash.events.Eventflash.events.Event.TAB_ENABLED_CHANGE| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
对象的 tabEnabled 标志发生更改时调度。
Event.TAB_ENABLED_CHANGE 常量定义 tabEnabledChange 事件对象的 type 属性值。
tabEnabledChange 事件适用于 ActionScript 3.0 显示列表并且与 JavaScript 代码无关。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles
|
true
|
cancelable
|
false;没有要取消的默认行为。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target
|
其 tabEnabled 标志已更改的 InteractiveObject。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。
|
| tabIndexChange | 事件 |
flash.events.Eventflash.events.Event.TAB_INDEX_CHANGE| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
对象的 tabIndex 属性值发生更改时调度。
Event.TAB_INDEX_CHANGE 常量定义 tabIndexChange 事件对象的 type 属性值。
tabIndexChange 事件适用于 ActionScript 3.0 显示列表并且与 JavaScript 代码无关。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles
|
true
|
cancelable
|
false;没有要取消的默认行为。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target
|
其 tabIndex 已更改的对象。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。
|
InteractiveObjectExample 类,该类再使用 ChildSprite 类来绘制矩形,然后基于各种鼠标事件对该矩形进行操作。执行下列步骤可完成该任务:
InteractiveObjectExample 构造函数中,创建一个名为 child 的 Sprite 类型的 ChildSprite 新对象,该对象调用 ChildSprite 构造函数方法来绘制形状,并为所绘制的形状添加鼠标事件(如以下步骤所示)。child 对象添加至坐标 x = 0, y = 0 处的显示列表顶部。
ChildSprite 类中,声明以后在 draw() 方法和 MouseEvent 方法中使用的 size 和 overSize 属性。
ChildSprite 构造函数中,通过使用 Graphics 类的方法和 draw() 方法绘制一个橙色的正方形。
mouseOverHandler:使用深黄色在原始坐标处重绘一个更大的 60 x 60 像素正方形。
mouseOutHandler:将正方形恢复至其原始大小和颜色。
mouseDownHandler:使用浅蓝色在原始坐标处重绘一个更大的 60 x 60 像素正方形。
mouseUpHandler:与 mouseOverHandler 相同。
package {
import flash.display.Sprite;
public class InteractiveObjectExample extends Sprite {
public function InteractiveObjectExample() {
var child:Sprite = 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() {
buttonMode = true;
draw(size, size, backgroundColor);
addEventListener(MouseEvent.MOUSE_OVER, mouseOverHandler);
addEventListener(MouseEvent.MOUSE_OUT, mouseOutHandler);
addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);
addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);
}
private function draw(w:uint, h:uint, bgColor:uint):void {
graphics.clear();
graphics.beginFill(bgColor);
graphics.drawRect(0, 0, w, h);
graphics.endFill();
}
public function mouseOverHandler(event:MouseEvent):void {
trace("mouseOverHandler");
draw(overSize, overSize, overColor);
}
public function mouseOutHandler(event:MouseEvent):void {
trace("mouseOutHandler");
draw(size, size, backgroundColor);
}
public function mouseDownHandler(event:MouseEvent):void {
trace("mouseDownHandler");
draw(overSize, overSize, downColor);
}
public function mouseUpHandler(event:MouseEvent):void {
trace("mouseUpHandler");
draw(overSize, overSize, overColor);
}
}