运行时版本: | AIR 1.0 Flash Player 9 |
InteractiveObject 类是用户可以使用鼠标和键盘与之交互的所有显示对象的抽象基类。
不能直接实例化 InteractiveObject 类。调用 new InteractiveObject()
构造函数会引发 ArgumentError
异常。
InteractiveObject 类本身不包含任何用于在屏幕上呈现内容的 API。鉴于此原因,如果要创建 InteractiveObject 类的一个自定义子类,您将需要扩展其中一个具有在屏幕上显示内容的 API 的子类,如 Sprite、SimpleButton、TextField 或 MovieClip 类。
查看示例
contextMenu:NativeMenu
[读写]
运行时版本: | 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:Boolean
[读写]
运行时版本: | 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:Object
[读写]
运行时版本: | 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:Boolean
[读写]
运行时版本: | 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:Boolean
[读写]
运行时版本: | AIR 1.0 Flash Player 9 |
指定此对象是否遵循 Tab 键顺序。如果该对象遵循 Tab 键顺序,值为 true
;否则值为 false
。默认情况下,值为 false
,但以下情况除外:
-
对于 SimpleButton 对象,值为
true
。
-
对于具有
type = "input"
的 TextField 对象,值为 true
。
-
对于具有
buttonMode = true
的 Sprite 对象或 MovieClip 对象,值为 true
。
实现 public function get tabEnabled():Boolean
public function set tabEnabled(value:Boolean):void
tabIndex:int
[读写]
运行时版本: | 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
public function InteractiveObject()
运行时版本: | AIR 1.0 Flash Player 9 |
调用 new InteractiveObject()
构造函数会引发 ArgumentError
异常。但是,可以调用以下 InteractiveObject 的子类的构造函数:
-
new SimpleButton()
-
new TextField()
-
new Loader()
-
new Sprite()
-
new MovieClip()
事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.CLEAR
运行时版本: | Flash Player 10, AIR 1.5 |
当用户从文本上下文菜单中选择“清除”(或“删除”)时调度。将此事件调度到当前具有焦点的对象。如果当前具有焦点的对象是一个 TextField,则此事件的默认行为是删除该文本字段中当前选定的所有文本。
Event.CLEAR
常量定义
clear
事件对象的
type
属性的值。
此事件具有以下属性:
属性 | 值 |
---|
bubbles
|
false
|
cancelable
|
false ;没有要取消的默认行为。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target
|
具有为 clear 事件注册的侦听器的任何 InteractiveObject 实例。
|
事件对象类型: flash.events.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.CLICK
运行时版本: | 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.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.CONTEXT_MENU
当用户在 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 属性来访问显示列表中当前正在处理此事件的对象。
|
另请参见
事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.COPY
运行时版本: | Flash Player 10, AIR 1.5 |
当用户激活特定于平台的复制操作的快捷键组合或从文本上下文菜单中选择“复制”时调度。将此事件调度到当前具有焦点的对象。如果当前具有焦点的对象是一个 TextField,则此事件的默认行为是将该文本字段中当前选定的所有文本复制到剪贴板。
定义
copy
事件对象的
type
属性值。
此事件具有以下属性:
属性 | 值 |
---|
bubbles
|
false
|
cancelable
|
false ;没有要取消的默认行为。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target
|
具有为 copy 事件注册的侦听器的任何 InteractiveObject 实例。
|
事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.CUT
运行时版本: | Flash Player 10, AIR 1.5 |
当用户激活特定于平台的剪切操作的快捷键组合或从文本上下文菜单中选择“剪切”时调度。将此事件调度到当前具有焦点的对象。如果当前具有焦点的对象是一个 TextField,则此事件的默认行为是将该文本字段中当前选定的所有文本剪切到剪贴板。
定义
cut
事件对象的
type
属性值。
此事件具有以下属性:
属性 | 值 |
---|
bubbles
|
false
|
cancelable
|
false ;没有要取消的默认行为。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target
|
具有为 cut 事件注册的侦听器的任何 InteractiveObject 实例。
|
事件对象类型: flash.events.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.DOUBLE_CLICK
运行时版本: | 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 属性来访问显示列表中当前正在处理此事件的对象。
|
另请参见
事件对象类型: flash.events.FocusEvent
属性 FocusEvent.type = flash.events.FocusEvent.FOCUS_IN
运行时版本: | 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 。
|
事件对象类型: flash.events.FocusEvent
属性 FocusEvent.type = flash.events.FocusEvent.FOCUS_OUT
运行时版本: | 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 属性来访问显示列表中当前正在处理此事件的对象。
|
事件对象类型: flash.events.KeyboardEvent
属性 KeyboardEvent.type = flash.events.KeyboardEvent.KEY_DOWN
运行时版本: | 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 属性来访问显示列表中当前正在处理此事件的对象。
|
另请参见
事件对象类型: flash.events.FocusEvent
属性 FocusEvent.type = flash.events.FocusEvent.KEY_FOCUS_CHANGE
运行时版本: | 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 属性来访问显示列表中当前正在处理此事件的对象。
|
事件对象类型: flash.events.KeyboardEvent
属性 KeyboardEvent.type = flash.events.KeyboardEvent.KEY_UP
运行时版本: | 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.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.MIDDLE_CLICK
当用户在同一 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.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.MIDDLE_MOUSE_DOWN
当用户在 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.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.MIDDLE_MOUSE_UP
当用户在 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 属性来访问显示列表中当前正在处理此事件的对象。
|
事件对象类型: flash.events.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.MOUSE_DOWN
运行时版本: | 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 属性来访问显示列表中当前正在处理此事件的对象。
|
事件对象类型: flash.events.FocusEvent
属性 FocusEvent.type = flash.events.FocusEvent.MOUSE_FOCUS_CHANGE
运行时版本: | 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 属性来访问显示列表中当前正在处理此事件的对象。
|
事件对象类型: flash.events.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.MOUSE_MOVE
运行时版本: | 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 属性来访问显示列表中当前正在处理此事件的对象。
|
事件对象类型: flash.events.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.MOUSE_OUT
运行时版本: | 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 属性来访问显示列表中当前正在处理此事件的对象。
|
事件对象类型: flash.events.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.MOUSE_OVER
运行时版本: | 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 属性来访问显示列表中当前正在处理此事件的对象。
|
事件对象类型: flash.events.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.MOUSE_UP
运行时版本: | 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 属性来访问显示列表中当前正在处理此事件的对象。
|
事件对象类型: flash.events.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.MOUSE_WHEEL
运行时版本: | 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.NativeDragEvent
属性 NativeDragEvent.type = flash.events.NativeDragEvent.NATIVE_DRAG_COMPLETE
当用户释放拖动动作时由拖动启动器 InteractiveObject 调度。
该事件的 dropAction 属性指示由拖动目标对象设置的动作;“none”值 (DragActions.NONE
) 指示放置动作被取消或未被接受。
nativeDragComplete
事件处理函数是更新启动显示对象的方便场所,例如,通过从列表中删除一个项目(针对“move”的拖动动作),或通过更改可视属性。
NativeDragEvent.NATIVE_DRAG_COMPLETE 定义
nativeDragComplete
事件对象的
type
属性值。
此事件具有以下属性:
属性 | 值 |
---|
allowedActions
| 指定与此拖动操作相关的动作的 NativeDragOptions 对象。 |
bubbles
|
false
|
cancelable
|
false ;没有要取消的默认行为。
|
clipboard
| 包含拖动数据的 Clipboard 对象。 |
dropAction
|
由放置目标选择的动作(或在未设置任何动作时为 none )。
|
事件对象类型: flash.events.NativeDragEvent
属性 NativeDragEvent.type = flash.events.NativeDragEvent.NATIVE_DRAG_DROP
在将拖动对象放置到目标上且已通过对 DragManager.acceptDragDrop() 的调用接受该放置操作时,由目标 InteractiveObject 调度。
使用事件对象的 clipboard
属性访问放置的数据。
此事件的处理函数应该设置 DragManager.dropAction
属性以向启动器提供有关采取了哪种拖动动作的反馈。如果未设置任何值,DragManager 将从允许动作的列表中选择一个默认值。
NativeDragEvent.NATIVE_DRAG_DROP 定义
nativeDragDrop
事件对象的
type
属性值。
此事件具有以下属性:
属性 | 值 |
---|
allowedActions
| 指定与此拖动操作相关的动作的 NativeDragOptions 对象。 |
bubbles
|
false
|
cancelable
|
true ;取消此事件会取消拖动操作。
|
clipboard
| 包含拖动数据的 Clipboard 对象。即使在调度此事件的对象与启动器不在同一安全域中时也可以读取剪贴板。 |
dropAction
|
由放置目标选择的动作(或在未设置任何动作时为 none )。
|
事件对象类型: flash.events.NativeDragEvent
属性 NativeDragEvent.type = flash.events.NativeDragEvent.NATIVE_DRAG_ENTER
当拖动动作进入其边界时由 InteractiveObject 调度。
处理 nativeDragEnter
或 nativeDragOver
事件以允许显示对象成为放置目标。
若要确定执行调度的显示对象是否能接受放置,请检查该事件对象的 clipboard
属性中数据的适用性,并检查 allowedActions
属性中允许的拖动动作。
NativeDragEvent.NATIVE_DRAG_ENTER 定义
nativeDragEnter
事件对象的
type
属性值。
此事件具有以下属性:
属性 | 值 |
---|
allowedActions
| 指定与此拖动操作相关的动作的 NativeDragOptions 对象。 |
bubbles
|
false
|
cancelable
|
false ;没有要取消的默认行为。
|
clipboard
| 包含拖动数据的 Clipboard 对象。只有当调度此事件的对象与启动器位于同一安全域中时才能读取剪贴板。 |
dropAction
|
由放置目标选择的动作(或在未设置任何动作时为 none )。
|
事件对象类型: flash.events.NativeDragEvent
属性 NativeDragEvent.type = flash.events.NativeDragEvent.NATIVE_DRAG_EXIT
当拖动动作离开其边界时由 InteractiveObject 调度。
NativeDragEvent.NATIVE_DRAG_EXIT 定义
nativeDragExit
事件对象的
type
属性值。
此事件具有以下属性:
属性 | 值 |
---|
allowedActions
| 指定与此拖动操作相关的动作的 NativeDragOptions 对象。 |
bubbles
|
false
|
cancelable
|
false ;没有要取消的默认行为。
|
clipboard
| 包含拖动数据的 Clipboard 对象。只有当调度此事件的对象与启动器位于同一安全域中时才能读取剪贴板。 |
dropAction
|
由放置目标选择的动作(或在未设置任何动作时为 none )。
|
事件对象类型: flash.events.NativeDragEvent
属性 NativeDragEvent.type = flash.events.NativeDragEvent.NATIVE_DRAG_OVER
当拖动动作保持在其边界内时,由 InteractiveObject 持续调度。
鼠标只要移动,就会调度 nativeDragOver
事件。在 Windows 和 Mac 中,即使不移动鼠标,每隔一小段时间也会调度这些事件。
处理 nativeDragOver
或 nativeDragEnter
事件以允许显示对象成为放置目标。
若要确定执行调度的显示对象是否能接受放置,请检查该事件对象的 clipboard
属性中数据的适用性,并检查 allowedActions
属性中允许的拖动动作。
NativeDragEvent.NATIVE_DRAG_OVER 定义
nativeDragOver
事件对象的
type
属性值。
此事件具有以下属性:
属性 | 值 |
---|
allowedActions
| 指定与此拖动操作相关的动作的 NativeDragOptions 对象。 |
bubbles
|
false
|
cancelable
|
true ;取消此事件会取消拖动操作。
|
clipboard
| 包含拖动数据的 Clipboard 对象。只有当调度此事件的对象与启动器位于同一安全域中时才能读取剪贴板。 |
dropAction
|
由放置目标选择的动作(或在未设置任何动作时为 none )。
|
事件对象类型: flash.events.NativeDragEvent
属性 NativeDragEvent.type = flash.events.NativeDragEvent.NATIVE_DRAG_START
在拖动操作开始时由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。
NativeDragEvent.NATIVE_DRAG_START 定义
nativeDragStart
事件对象的
type
属性值。
此事件具有以下属性:
属性 | 值 |
---|
allowedActions
| 指定与此拖动操作相关的动作的 NativeDragOptions 对象。 |
bubbles
|
false
|
cancelable
|
true ;取消此事件会取消拖动操作。
|
clipboard
| 包含拖动数据的 Clipboard 对象。 |
dropAction
|
由放置目标选择的动作(或在未设置任何动作时为 none )。
|
事件对象类型: flash.events.NativeDragEvent
属性 NativeDragEvent.type = flash.events.NativeDragEvent.NATIVE_DRAG_UPDATE
在拖动操作期间由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。
Linux 中不调度 nativeDragUpdate
事件。
NativeDragEvent.NATIVE_DRAG_UPDATE 定义
nativeDragUpdate
事件对象的
type
属性值。
此事件具有以下属性:
属性 | 值 |
---|
allowedActions
| 指定与此拖动操作相关的动作的 NativeDragOptions 对象。 |
bubbles
|
false
|
cancelable
|
false ;没有要取消的默认行为。
|
clipboard
| 包含拖动数据的 Clipboard 对象。 |
dropAction
|
由放置目标选择的动作(或在未设置任何动作时为 none )。
|
事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.PASTE
运行时版本: | Flash Player 10, AIR 1.5 |
当用户激活特定于平台的粘贴操作的快捷键组合或从文本上下文菜单中选择“粘贴”时调度。将此事件调度到当前具有焦点的对象。如果当前具有焦点的对象是一个 TextField,则此事件的默认行为是将剪贴板的所有内容粘贴到该文本字段的当前插入点,替换文本字段中当前选定的所有文本。
Event.PASTE
常量定义
paste
事件对象的
type
属性的值。
此事件具有以下属性:
属性 | 值 |
---|
bubbles
|
false
|
cancelable
|
false ;没有要取消的默认行为。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target
|
具有为 paste 事件注册的侦听器的任何 InteractiveObject 实例。
|
事件对象类型: flash.events.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.RIGHT_CLICK
当用户在同一 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.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.RIGHT_MOUSE_DOWN
当用户在 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.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.RIGHT_MOUSE_UP
当用户在 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 属性来访问显示列表中当前正在处理此事件的对象。
|
事件对象类型: flash.events.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.ROLL_OUT
运行时版本: | 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 属性来访问显示列表中当前正在处理此事件的对象。
|
事件对象类型: flash.events.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.ROLL_OVER
运行时版本: | 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 属性来访问显示列表中当前正在处理此事件的对象。
|
事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.SELECT_ALL
运行时版本: | Flash Player 10, AIR 1.5 |
当用户激活特定于平台的全选操作的快捷键组合或从文本上下文菜单中选择“全选”时调度。将此事件调度到当前具有焦点的对象。如果当前具有焦点的对象是一个 TextField,则此事件的默认行为是使该文本字段的所有内容处于选定状态。
Event.SELECT_ALL
常量定义
selectAll
事件对象的
type
属性的值。
此事件具有以下属性:
属性 | 值 |
---|
bubbles
|
false
|
cancelable
|
false ;没有要取消的默认行为。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target
|
具有为 selectAll 事件注册的侦听器的任何 InteractiveObject 实例。
|
事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.TAB_CHILDREN_CHANGE
运行时版本: | AIR 1.0 Flash Player 9 |
对象的 tabChildren
标志值发生更改时调度。
Event.TAB_CHILDREN_CHANGE
常量定义
tabChildrenChange
事件对象的
type
属性值。
此事件具有以下属性:
属性 | 值 |
---|
bubbles
|
true
|
cancelable
|
false ;没有要取消的默认行为。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target
|
其 tabChildren 标志已更改的对象。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。
|
事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.TAB_ENABLED_CHANGE
运行时版本: | 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 属性来访问显示列表中当前正在处理此事件的对象。
|
事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.TAB_INDEX_CHANGE
运行时版本: | 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()
方法绘制一个橙色的正方形。
-
构造函数添加四个 MouseEvent 事件侦听器方法:
-
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);
}
}
© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Sun Dec 14 2008, 10:39 PM -08:00