| RuntimeVersions: | AIR 1.0, Flash Player 9 |
InteractiveObject 类是用户可以使用鼠标和键盘与之交互的所有显示对象的抽象基类。
不能直接实例化 InteractiveObject 类。调用 new InteractiveObject() 构造函数会引发 ArgumentError 异常。
InteractiveObject 类本身不包含任何用于在屏幕上呈现内容的 API。鉴于此原因,如果要创建 InteractiveObject 类的一个自定义子类,您将需要扩展其中一个具有在屏幕上显示内容的 API 的子类,如 Sprite、SimpleButton、TextField 或 MovieClip 类。
查看示例
contextMenu:NativeMenu []
| RuntimeVersions: | 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):voiddoubleClickEnabled:Boolean []
| RuntimeVersions: | 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 []
| RuntimeVersions: | AIR 1.0, Flash Player 9 |
指定此对象是否显示焦点矩形。null 值指示该对象遵循对舞台设置的 stageFocusRect 属性。
实现 public function get focusRect():Object public function set focusRect(value:Object):voidmouseEnabled:Boolean []
| RuntimeVersions: | 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 []
| RuntimeVersions: | 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):voidtabIndex:int []
| RuntimeVersions: | 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):voidpublic function InteractiveObject()| RuntimeVersions: | AIR 1.0, Flash Player 9 |
调用 new InteractiveObject() 构造函数会引发 ArgumentError 异常。但是,可以调用以下 InteractiveObject 的子类的构造函数:
new SimpleButton()new TextField()new Loader()new Sprite()new MovieClip()
事件对象类型: flash.events.MouseEventMouseEvent.type 属性 = flash.events.MouseEvent.CLICK| RuntimeVersions: | AIR 1.0, Flash Player 9 |
用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。要使单击事件发生,它必须始终在以下顺序的一系列事件后面:mouseDown 事件,然后是 mouseUp 事件。这两个事件的目标对象必须相同,否则不会发生 click 事件。mouseDown 或 mouseUp 事件之间的任何时间会发生任何数量的其它鼠标事件;click 事件仍会发生。
定义
click 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
bubbles | true |
buttonDown | 如果按下鼠标主按键,则为 true;否则为 false。 |
cancelable | false;没有要取消的默认行为。 |
ctrlKey | 在 Windows 中,如果 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.MouseEventMouseEvent.type 属性 = flash.events.MouseEvent.CONTEXT_MENU
当用户在 AIR 应用程序中选择与此交互式对象相关联的上下文菜单时调度。
InteractiveIconMouseEvent.CONTEXT_MENU 常量定义
contextMenu 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
bubbles | true |
cancelable | true |
screenX | 单击的屏幕坐标中的 X 位置。 |
screenY | 单击的屏幕坐标中的 Y 位置。 |
另请参见
事件对象类型: flash.events.MouseEventMouseEvent.type 属性 = flash.events.MouseEvent.DOUBLE_CLICK| RuntimeVersions: | 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 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
bubbles | true |
buttonDown | 如果按下鼠标主按键,则为 true;否则为 false。 |
cancelable | false;没有要取消的默认行为。 |
ctrlKey | 在 Windows 中,如果 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.FocusEventFocusEvent.type 属性 = flash.events.FocusEvent.FOCUS_IN| RuntimeVersions: | 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.FocusEventFocusEvent.type 属性 = flash.events.FocusEvent.FOCUS_OUT| RuntimeVersions: | 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.KeyboardEventKeyboardEvent.type 属性 = flash.events.KeyboardEvent.KEY_DOWN| RuntimeVersions: | AIR 1.0, Flash Player 9 |
用户按下某个键时调度。按键与特定字符之间的映射因设备和操作系统而异。此事件类型是在此类映射发生之后、输入法编辑器 (IME) 处理之前生成的。IME 用于输入标准 QWERTY 键盘无法生成的字符(如中国象形文字)。该事件在 keyUp 事件之前发生。
定义
keyDown 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
bubbles | true |
cancelable | false;没有要取消的默认行为。 |
charCode | 按下或释放的键的字符代码值。 |
ctrlKey | 在 Windows 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 true。否则为 false。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
keyCode | 按下或释放的键的键控代码值。 |
keyLocation | 按键在键盘上的位置。 |
shiftKey | 如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false。 |
target | 具有焦点的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。 |
事件对象类型: flash.events.FocusEventFocusEvent.type 属性 = flash.events.FocusEvent.KEY_FOCUS_CHANGE| RuntimeVersions: | 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.KeyboardEventKeyboardEvent.type 属性 = flash.events.KeyboardEvent.KEY_UP| RuntimeVersions: | AIR 1.0, Flash Player 9 |
用户释放某个键时调度。按键与特定字符之间的映射因设备和操作系统而异。此事件类型是在此类映射发生之后、输入法编辑器 (IME) 处理之前生成的。IME 用于输入标准 QWERTY 键盘无法生成的字符(如中国象形文字)。该事件在 keyDown 事件之后发生,并具备以下特征:
定义
keyUp 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
bubbles | true |
cancelable | false;没有要取消的默认行为。 |
charCode | 包含按下或释放的键的字符代码值。 |
ctrlKey | 在 Windows 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 true。否则为 false。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
keyCode | 按下或释放的键的键控代码值。 |
keyLocation | 按键在键盘上的位置。 |
shiftKey | 如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false。 |
target | 具有焦点的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。 |
事件对象类型: flash.events.MouseEventMouseEvent.type 属性 = flash.events.MouseEvent.MIDDLE_CLICK
当用户在同一 InteractiveObject 上按下并释放用户指针设备的中间按钮时调度。要使 middleClick 事件发生,该事件必须始终按照发生顺序跟在以下一系列事件之后:middleMouseDown 事件,然后是 middleMouseUp。这两个事件的目标对象必须相同,否则不会发生 middleClick 事件。在 middleMouseDown 或 middleMouseUp 事件之间可以随时发生任意数量的其他鼠标事件;middleClick 事件仍会发生。
定义
middleClick 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
bubbles | true |
buttonDown | 如果按下鼠标中键,则为 true;否则为 false。 |
cancelable | false;没有要取消的默认行为。 |
ctrlKey | 在 Windows 中,如果 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.MouseEventMouseEvent.type 属性 = flash.events.MouseEvent.MIDDLE_MOUSE_DOWN
当用户在 InteractiveObject 实例上按下指针设备的中间按钮时调度。
定义
middleMouseDown 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
bubbles | true |
buttonDown | 如果按下鼠标中键,则为 true;否则为 false。 |
cancelable | false;不能取消默认行为。 |
ctrlKey | 在 Windows 中,如果 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.MouseEventMouseEvent.type 属性 = flash.events.MouseEvent.MIDDLE_MOUSE_UP
当用户在 InteractiveObject 实例上释放指针设备按钮时调度。
定义
middleMouseUp 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
bubbles | true |
buttonDown | 如果按下鼠标中键,则为 true;否则为 false。 |
cancelable | false;不能取消默认行为。 |
ctrlKey | 在 Windows 中,如果 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.MouseEventMouseEvent.type 属性 = flash.events.MouseEvent.MOUSE_DOWN| RuntimeVersions: | AIR 1.0, Flash Player 9 |
当用户在 InteractiveObject 实例上按下指针设备按钮时调度。如果目标为 SimpleButton 实例,作为默认行为,SimpleButton 实例会显示 downState 显示对象。如果目标为可选文本字段,作为默认行为,该文本字段会开始选择。
定义
mouseDown 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
bubbles | true |
buttonDown | 如果按下鼠标主按键,则为 true;否则为 false。 |
cancelable | false;不能取消默认行为。 |
ctrlKey | 在 Windows 中,如果 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.FocusEventFocusEvent.type 属性 = flash.events.FocusEvent.MOUSE_FOCUS_CHANGE| RuntimeVersions: | 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.MouseEventMouseEvent.type 属性 = flash.events.MouseEvent.MOUSE_MOVE| RuntimeVersions: | AIR 1.0, Flash Player 9 |
用户移动 InteractiveObject 上的指针设备时调度。如果目标为用户正在选择的文本字段,则作为默认行为,会更新选择。
定义
mouseMove 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
bubbles | true |
buttonDown | 如果按下鼠标主按键,则为 true;否则为 false。 |
cancelable | false;不能取消默认行为。 |
ctrlKey | 在 Windows 中,如果 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.MouseEventMouseEvent.type 属性 = flash.events.MouseEvent.MOUSE_OUT| RuntimeVersions: | AIR 1.0, Flash Player 9 |
用户将指针设备从 InteractiveObject 实例上移开时调度。事件目标是指先前在指针设备下的对象。relatedObject 是将指针设备向其移动的对象。如果目标为 SimpleButton 实例,作为默认行为,该按钮会显示 upState 显示对象。
每次鼠标离开显示对象容器的任何子对象区域时都会调度 mouseOut 事件,即使鼠标停留在显示对象容器的另一个子对象上也是如此。此行为不同于 rollOut 事件的用途,此事件用于简化带有子级的显示对象容器的滑过行为的编码。当鼠标离开某个显示对象区域或任何其子级区域以转到其子级以外的对象时,该显示对象将调度 rollOut 事件。rollOut 事件是沿该对象的父级链向上连续调度的,从该对象开始,并以 relatedObject 的根或始祖之外的最高父级结束。
定义
mouseOut 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
bubbles | true |
buttonDown | 如果按下鼠标主按键,则为 true;否则为 false。 |
cancelable | false;不能取消默认行为。 |
ctrlKey | 在 Windows 中,如果 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.MouseEventMouseEvent.type 属性 = flash.events.MouseEvent.MOUSE_OVER| RuntimeVersions: | AIR 1.0, Flash Player 9 |
用户将指针设备移动到 InteractiveObject 实例上时调度。relatedObject 是以前在指针设备下的对象。如果目标为 SimpleButton 实例,作为默认行为,该对象会根据是否按下鼠标按键而显示 overState 或 upState 显示对象。
每次鼠标进入显示对象容器的任何子对象区域时都会调度 mouseOver 事件,即使鼠标已在显示对象容器的另一个子对象上也是如此。此行为不同于 rollOver 事件的用途,此事件用于简化带有子级的显示对象容器的移出行为的编码。当鼠标进入某个显示对象区域或者从其子级以外的对象进入任何其子级区域时,该显示对象将调度 rollOver 事件。rollOver 事件是沿该对象的父级链向下连续调度的,从 relatedObject 的根或始祖之外的最高父级开始,并以该对象结束。
定义
mouseOver 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
bubbles | true |
buttonDown | 如果按下鼠标主按键,则为 true;否则为 false。 |
cancelable | false;不能取消默认行为。 |
ctrlKey | 在 Windows 中,如果 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.MouseEventMouseEvent.type 属性 = flash.events.MouseEvent.MOUSE_UP| RuntimeVersions: | AIR 1.0, Flash Player 9 |
当用户在 InteractiveObject 实例上释放指针设备按钮时调度。如果目标为 SimpleButton 实例,该对象会显示 upState 显示对象。如果目标为可选文本字段,则作为默认行为,该文本字段会结束选择。
定义
mouseUp 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
bubbles | true |
buttonDown | 如果按下鼠标主按键,则为 true;否则为 false。 |
cancelable | false;不能取消默认行为。 |
ctrlKey | 在 Windows 中,如果 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.MouseEventMouseEvent.type 属性 = flash.events.MouseEvent.MOUSE_WHEEL| RuntimeVersions: | AIR 1.0, Flash Player 9 |
当鼠标滚轮滚动到 InteractiveObject 实例上时调度。如果目标为文本字段,则作为默认行为,该文本会滚动。
定义
mouseWheel 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
bubbles | true |
buttonDown | 如果按下鼠标主按键,则为 true;否则为 false。 |
cancelable | false;不能取消默认行为。 |
ctrlKey | 在 Windows 中,如果 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.NativeDragEventNativeDragEvent.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.NativeDragEventNativeDragEvent.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.NativeDragEventNativeDragEvent.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.NativeDragEventNativeDragEvent.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.NativeDragEventNativeDragEvent.type 属性 = flash.events.NativeDragEvent.NATIVE_DRAG_OVER
当拖动动作保持在其边界内时,由 InteractiveObject 持续调度。
nativeDragOver 事件在计时器上调度,并且每当鼠标移动时即调度。
处理 nativeDragOver 或 nativeDragEnter 事件以允许显示对象成为放置目标。
若要确定执行调度的显示对象是否能接受放置,请检查该事件对象的 clipboard 属性中数据的适用性,并检查 allowedActions 属性中允许的拖动动作。
NativeDragEvent.NATIVE_DRAG_OVER 定义
nativeDragOver 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
allowedActions | 指定与此拖动操作相关的动作的 NativeDragOptions 对象。 |
bubbles | false |
cancelable | true;取消此事件会取消拖动操作。 |
clipboard | 包含拖动数据的 Clipboard 对象。只有当调度此事件的对象与启动器位于同一安全域中时才能读取剪贴板。 |
dropAction | 由放置目标选择的动作(或在未设置任何动作时为 none)。 |
事件对象类型: flash.events.NativeDragEventNativeDragEvent.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.NativeDragEventNativeDragEvent.type 属性 = flash.events.NativeDragEvent.NATIVE_DRAG_UPDATE
在拖动操作期间由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。
NativeDragEvent.NATIVE_DRAG_UPDATE 定义
nativeDragUpdate 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
allowedActions | 指定与此拖动操作相关的动作的 NativeDragOptions 对象。 |
bubbles | false |
cancelable | false;没有要取消的默认行为。 |
clipboard | 包含拖动数据的 Clipboard 对象。 |
dropAction | 由放置目标选择的动作(或在未设置任何动作时为 none)。 |
事件对象类型: flash.events.MouseEventMouseEvent.type 属性 = flash.events.MouseEvent.RIGHT_CLICK
当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。要使 rightClick 事件发生,该事件必须始终按照发生顺序跟在以下一系列事件之后:rightMouseDown 事件,然后是 rightMouseUp。这两个事件的目标对象必须相同,否则不会发生 rightClick 事件。在 rightMouseDown 或 rightMouseUp 事件之间可以随时发生任意数量的其他鼠标事件;rightClick 事件仍会发生。
定义
rightClick 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
bubbles | true |
buttonDown | 如果按下鼠标右键,则为 true;否则为 false。 |
cancelable | false;没有要取消的默认行为。 |
ctrlKey | 在 Windows 中,如果 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.MouseEventMouseEvent.type 属性 = flash.events.MouseEvent.RIGHT_MOUSE_DOWN
当用户在 InteractiveObject 实例上按下指针设备按钮时调度。
定义
rightMouseDown 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
bubbles | true |
buttonDown | 如果按下鼠标右键,则为 true;否则为 false。 |
cancelable | false;不能取消默认行为。 |
ctrlKey | 在 Windows 中,如果 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.MouseEventMouseEvent.type 属性 = flash.events.MouseEvent.RIGHT_MOUSE_UP
当用户在 InteractiveObject 实例上释放指针设备按钮时调度。
定义
rightMouseUp 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
bubbles | true |
buttonDown | 如果按下鼠标右键,则为 true;否则为 false。 |
cancelable | false;不能取消默认行为。 |
ctrlKey | 在 Windows 中,如果 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.MouseEventMouseEvent.type 属性 = flash.events.MouseEvent.ROLL_OUT| RuntimeVersions: | AIR 1.0, Flash Player 9 |
用户将指针设备从 InteractiveObject 实例上移开时调度。事件目标是指先前在指针设备下的对象或该对象的父级。relatedObject 是将指针设备向其移动的对象。在该对象的父级链以上连续调度 rollOut 事件,以该对象为开头,并以除 relatedObject 的根或始祖之外的最高级别的父级结束。
rollOut 事件的目的是简化带有子级的显示对象容器的移开行为的编码。当鼠标离开显示对象区域或任何其子级区域并转到除其子级以外的对象时,显示对象调度 rollOut 事件。这是与 mouseOut 事件行为不同的行为,因为该事件是在每次鼠标离开显示对象容器的任何子对象区域时才会被调度,即使鼠标仍保留在显示对象容器的另一个子对象上也是如此。
定义
rollOut 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
bubbles | false |
buttonDown | 如果按下鼠标主按键,则为 true;否则为 false。 |
cancelable | false;没有要取消的默认行为。 |
ctrlKey | 在 Windows 中,如果 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.MouseEventMouseEvent.type 属性 = flash.events.MouseEvent.ROLL_OVER| RuntimeVersions: | AIR 1.0, Flash Player 9 |
用户将指针设备移动到 InteractiveObject 实例上时调度。事件目标为指针设备下的对象或该对象的父级。relatedObject 是以前在指针设备下的对象。在该对象的父级链以下连续调度 rollOver 事件,以除 relatedObject 的根或始祖之外的最高级别的父级开头,并以该对象结束。
rollOver 事件的目的是简化带有子级的显示对象容器的移开行为的编码。当鼠标进入某个显示对象区域或者从其子级以外的对象进入任何其子级区域时,该显示对象将调度 rollOver 事件。这种行为与 mouseOver 事件的行为不同,每次鼠标进入显示对象容器的任何子对象区域时都会调度此事件,即使鼠标已在显示对象容器的另一个子对象上也是如此。
定义
rollOver 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
bubbles | false |
buttonDown | 如果按下鼠标主按键,则为 true;否则为 false。 |
cancelable | false;没有要取消的默认行为。 |
ctrlKey | 在 Windows 中,如果 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.EventEvent.type 属性 = flash.events.Event.TAB_CHILDREN_CHANGE| RuntimeVersions: | 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.EventEvent.type 属性 = flash.events.Event.TAB_ENABLED_CHANGE| RuntimeVersions: | AIR 1.0, Flash Player 9 |
对象的 tabEnabled 标志发生更改时调度。
Event.TAB_ENABLED_CHANGE 常量定义
tabEnabledChange 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
bubbles | true |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 其 tabEnabled 标志已更改的 InteractiveObject。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。 |
事件对象类型: flash.events.EventEvent.type 属性 = flash.events.Event.TAB_INDEX_CHANGE| RuntimeVersions: | AIR 1.0, Flash Player 9 |
对象的 tabIndex 属性值发生更改时调度。
Event.TAB_INDEX_CHANGE 常量定义
tabIndexChange 事件对象的
type 属性值。
此事件具有以下属性:
| 属性 | 值 |
|---|
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.
Fri Jul 25 2008, 12:57 AM -07:00