flash.events.InvokeEvent (Flex 3.2)

（仅限 AIR）

包	flash.events
类	public class InvokeEvent
继承	InvokeEvent Event Object

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

在调用 AIR 应用程序时，该应用程序的 NativeApplication 对象将调度 invoke 事件。

在启动应用程序时，NativeApplication 对象始终调度 invoke 事件，但也可以在其他时间调度此事件。例如，当用户激活与正在运行的应用程序关联的文件时，此应用程序将会调度另一个 InvokeEvent。

只能启动特定应用程序的单个实例。随后尝试启动该应用程序将导致由正在运行的实例的 NativeApplication 对象调度一个新的 invoke 事件。应用程序负责处理此事件并采取适当的动作，例如打开一个新应用程序窗口以显示文件中的数据。

InvokeEvent 由 NativeApplication 对象 (NativeApplication.nativeApplication) 调度。若要接收 invoke 事件，请调用 NativeApplication 对象的 addEventListener() 方法。当某个事件侦听器针对 invoke 事件进行注册时，它还会接收到在注册前发生的所有 invoke 事件。这些先前的事件会在对 addEventListener() 的调用返回后（但并不一定在注册后可能调度的新 invoke 事件之前）进行调度。因此，不应依赖于调度顺序。

另请参见

flash.events.BrowserInvokeEvent
flash.desktop.NativeApplication

	属性	定义方
		arguments : Array [只读 (read-only)] 在此调用过程中传递的字符串参数的数组。	InvokeEvent
		bubbles : Boolean [只读 (read-only)] 指示事件是否为冒泡事件。	Event
		cancelable : Boolean [只读 (read-only)] 指示是否可以阻止与事件相关联的行为。	Event
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		currentDirectory : File [只读 (read-only)] 解析参数数组中的任何相对路径时应使用的目录。	InvokeEvent
		currentTarget : Object [只读 (read-only)] 当前正在使用某个事件侦听器处理 Event 对象的对象。	Event
		eventPhase : uint [只读 (read-only)] 事件流中的当前阶段。	Event
		prototype : Object [静态] 对类或函数对象的原型对象的引用。	Object
		target : Object [只读 (read-only)] 事件目标。	Event
		type : String [只读 (read-only)] 事件的类型。	Event

	方法	定义方
		InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null) InvokeEvent 类的构造函数。	InvokeEvent
		clone():Event 创建此事件的新副本。	InvokeEvent
		formatToString(className:String, ... arguments):String 用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。	Event
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		isDefaultPrevented():Boolean 检查是否已对事件调用 preventDefault() 方法。	Event
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		preventDefault():void 如果可以取消事件的默认行为，则取消该行为。	Event
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		stopImmediatePropagation():void 防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。	Event
		stopPropagation():void 防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。	Event
		toString():String 返回一个字符串，其中包含 Event 对象的所有属性。	Event
		valueOf():Object 返回指定对象的原始值。	Object

公共常量

隐藏继承的公共常量

显示继承的公共常量

	常量		定义方
		ACTIVATE : String = "activate" [静态] ACTIVATE 常量定义 activate 事件对象的 type 属性的值。	Event
		ADDED : String = "added" [静态] Event.ADDED 常量定义 added 事件对象的 type 属性值。	Event
		ADDED_TO_STAGE : String = "addedToStage" [静态] Event.ADDED_TO_STAGE 常量定义 addedToStage 事件对象的 type 属性值。	Event
		CANCEL : String = "cancel" [静态] Event.CANCEL 常量定义 cancel 事件对象的 type 属性的值。	Event
		CHANGE : String = "change" [静态] Event.CHANGE 常量定义 change 事件对象的 type 属性值。	Event
		CLEAR : String = "clear" [静态] Event.CLEAR 常量定义 clear 事件对象的 type 属性的值。	Event
		CLOSE : String = "close" [静态] Event.CLOSE 常量定义 close 事件对象的 type 属性的值。	Event
		CLOSING : String = "closing" [静态] Event.CLOSING 常量定义 closing 事件对象的 type 属性值。	Event
		COMPLETE : String = "complete" [静态] Event.COMPLETE 常量定义 complete 事件对象的 type 属性值。	Event
		CONNECT : String = "connect" [静态] Event.CONNECT 常量定义 connect 事件对象的 type 属性值。	Event
		COPY : String = "copy" [静态] 定义 copy 事件对象的 type 属性值。	Event
		CUT : String = "cut" [静态] 定义 cut 事件对象的 type 属性值。	Event
		DEACTIVATE : String = "deactivate" [静态] Event.DEACTIVATE 常量定义 deactivate 事件对象的 type 属性值。	Event
		DISPLAYING : String = "displaying" [静态] Event.DISPLAYING 常量定义 displaying 事件对象的 type 属性值。	Event
		ENTER_FRAME : String = "enterFrame" [静态] Event.ENTER_FRAME 常量定义 enterFrame 事件对象的 type 属性值。	Event
		EXIT_FRAME : String = "exitFrame" [静态] Event.EXIT_FRAME 常量定义 exitFrame 事件对象的 type 属性的值。	Event
		EXITING : String = "exiting" [静态] Event.EXITING 常量定义 exiting 事件对象的 type 属性值。	Event
		FRAME_CONSTRUCTED : String = "frameConstructed" [静态] Event.FRAME_CONSTRUCTED 常量定义 frameConstructed 事件对象的 type 属性的值。	Event
		FULLSCREEN : String = "fullScreen" [静态] Event.FULL_SCREEN 常量定义 fullScreen 事件对象的 type 属性值。	Event
		HTML_BOUNDS_CHANGE : String = "htmlBoundsChange" [静态] Event.HTML_BOUNDS_CHANGE 常量定义 htmlBoundsChange 事件对象的 type 属性值。	Event
		HTML_DOM_INITIALIZE : String = "htmlDOMInitialize" [静态] Event.HTML_DOM_INITIALIZE 常量定义 htmlDOMInitialize 事件对象的 type 属性值。	Event
		HTML_RENDER : String = "htmlRender" [静态] Event.HTML_RENDER 常量定义 htmlRender 事件对象的 type 属性值。	Event
		ID3 : String = "id3" [静态] Event.ID3 常量定义 id3 事件对象的 type 属性值。	Event
		INIT : String = "init" [静态] Event.INIT 常量定义 init 事件对象的 type 属性值。	Event
		INVOKE : String = "invoke" [静态] InvokeEvent.INVOKE 常量定义 InvokeEvent 对象的 type 属性值。	InvokeEvent
		LOCATION_CHANGE : String = "locationChange" [静态] Event.LOCATION_CHANGE 常量定义 locationChange 事件对象的 type 属性值。	Event
		MOUSE_LEAVE : String = "mouseLeave" [静态] Event.MOUSE_LEAVE 常量定义 mouseLeave 事件对象的 type 属性值。	Event
		NETWORK_CHANGE : String = "networkChange" [静态] Event.NETWORK_CHANGE 常量定义 networkChange 事件对象的 type 属性值。	Event
		OPEN : String = "open" [静态] Event.OPEN 常量用于定义 open 事件对象的 type 属性值。	Event
		PASTE : String = "paste" [静态] Event.PASTE 常量定义 paste 事件对象的 type 属性的值。	Event
		REMOVED : String = "removed" [静态] Event.REMOVED 常量定义 removed 事件对象的 type 属性值。	Event
		REMOVED_FROM_STAGE : String = "removedFromStage" [静态] Event.REMOVED_FROM_STAGE 常量定义 removedFromStage 事件对象的 type 属性值。	Event
		RENDER : String = "render" [静态] Event.RENDER 常量定义 render 事件对象的 type 属性的值。	Event
		RESIZE : String = "resize" [静态] Event.RESIZE 常量定义 resize 事件对象的 type 属性的值。	Event
		SCROLL : String = "scroll" [静态] Event.SCROLL 常量定义 scroll 事件对象的 type 属性值。	Event
		SELECT : String = "select" [静态] Event.SELECT 常量定义 select 事件对象的 type 属性的值。	Event
		SELECT_ALL : String = "selectAll" [静态] Event.SELECT_ALL 常量定义 selectAll 事件对象的 type 属性的值。	Event
		SOUND_COMPLETE : String = "soundComplete" [静态] Event.SOUND_COMPLETE 常量定义 soundComplete 事件对象的 type 属性值。	Event
		TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [静态] Event.TAB_CHILDREN_CHANGE 常量定义 tabChildrenChange 事件对象的 type 属性值。	Event
		TAB_ENABLED_CHANGE : String = "tabEnabledChange" [静态] Event.TAB_ENABLED_CHANGE 常量定义 tabEnabledChange 事件对象的 type 属性值。	Event
		TAB_INDEX_CHANGE : String = "tabIndexChange" [静态] Event.TAB_INDEX_CHANGE 常量定义 tabIndexChange 事件对象的 type 属性值。	Event
		UNLOAD : String = "unload" [静态] Event.UNLOAD 常量定义 unload 事件对象的 type 属性值。	Event
		USER_IDLE : String = "userIdle" [静态] Event.USER_IDLE 常量定义 userIdle 事件对象的 type 属性值。	Event
		USER_PRESENT : String = "userPresent" [静态] Event.USER_PRESENT 常量定义 userPresent 事件对象的 type 属性值。	Event

属性详细信息

arguments

属性

arguments:Array [只读 (read-only)]

运行时版本:

AIR 1.0

在此调用过程中传递的字符串参数的数组。如果是命令行调用，则该数组将包含命令行参数（除进程名称之外）。

注意：当在 Mac^® OS X 上选择并打开多个文件时，AIR 将调度单个 invoke 事件，该事件在 arguments 数组中包含所有所选文件的名称。但是，在 Windows ^® 和 Linux 中，AIR 将为 arguments 数组中只包含该文件名的每个所选文件调度一个单独的 invoke 事件。

实现
public function get arguments():Array

currentDirectory

属性

currentDirectory:File [只读 (read-only)]

运行时版本:

AIR 1.0

解析 arguments 数组中的任何相对路径时应使用的目录。

如果从命令行启动应用程序，则通常将此属性设置为启动应用程序的命令行解释程序的当前工作目录。如果从 GUI 解释程序启动应用程序，则此属性通常为文件系统根目录。

实现
public function get currentDirectory():File

构造函数详细信息

InvokeEvent

()

构造函数

public function InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null)

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

InvokeEvent 类的构造函数。

参数

	`type:String` — 事件的类型，可以作为 `Event.type` 访问。

	`bubbles:Boolean` (default = `false`) — 对于 InvokeEvent 对象设置为 `false`。

	`cancelable:Boolean` (default = `false`) — 对于 InvokeEvent 对象设置为 `false`。

	`dir:File` (default = `null`) — 解析 `arguments` 数组中的任何相对路径时应使用的目录。

	`argv:Array` (default = `null`) — 要传递给应用程序的参数（字符串）数组。

方法详细信息

clone

()

方法

override public function clone():Event

运行时版本:

AIR 1.0

创建此事件的新副本。

Event — 事件的副本。

常量详细信息

INVOKE

常量

public static const INVOKE:String = "invoke"

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

InvokeEvent.INVOKE 常量定义 InvokeEvent 对象的 type 属性值。

InvokeEvent 对象具有以下属性：

属性	Values
`arguments`	在此调用过程中传递的字符串参数的数组。
`currentDirectory`	一个File 对象，表示解析 arguments 数组中的任何相对路径时应使用的目录。
`bubbles`	`false` .
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	指示当前正在使用事件侦听器处理此 InvokeEvent 对象的对象。
`target`	始终为NativeApplication 对象。

另请参见

flash.desktop.NativeApplication

Adobe® Flex™ 3.2 语言参考		全部包 \| 全部类 \| 语言元素 \| 索引 \| 附录 \| 约定 \| 框架无框架
InvokeEvent	属性 \| 方法 \| 事件 \| 样式 \| 效果 \| 常量 \| 示例