InvokeEvent

包	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 事件之前）进行调度。因此，不应依赖于调度顺序。

公共属性

隐藏继承的公共属性

显示继承的公共属性

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

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null, reason:String = "standard") 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
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回一个字符串，其中包含 Event 对象的所有属性。	Event
		valueOf():Object 返回指定对象的原始值。	Object

公共常量

隐藏继承的公共常量

显示继承的公共常量

	常量		由以下参数定义
		INVOKE : String = "invoke" [静态] InvokeEvent.INVOKE 常量定义 InvokeEvent 对象的 type 属性值。	InvokeEvent

属性详细信息

arguments

属性

arguments:Array [只读]

运行时版本:

AIR 1.0

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

在移动设备平台上，此属性包含启动应用程序时使用的选项数组，而不是命令行参数。此外，在移动设备平台上，当 reason 为 InvokeEventR ason.OPEN_URL 时，arguments 数组的内容会相应改变，如下所示：

另一个应用程序或浏览器使用自定义 URL 调用该应用程序（iOS 和 Android）：
参数 iOS Android
InvokeEvent.arguments.length 3 2
InvokeEvent.arguments[0] url url
InvokeEvent.arguments[1] 源应用程序 id 动作 id
InvokeEvent.arguments[2] null NA
系统调用应用程序以打开关联的文件类型（iOS 和 Android）：
参数 iOS Android
InvokeEvent.arguments.length 3 2
InvokeEvent.arguments[0] url url
InvokeEvent.arguments[1] null 动作 id
InvokeEvent.arguments[2] null NA
另一个应用程序使用文档交互控制器调用该应用程序（仅 iOS）
参数 iOS
InvokeEvent.arguments.length 3
InvokeEvent.arguments[0] url
InvokeEvent.arguments[1] 源应用程序 id
InvokeEvent.arguments[2] 注释

参数	iOS	Android
`InvokeEvent.arguments.length`	3	2
`InvokeEvent.arguments[0]`	url	url
`InvokeEvent.arguments[1]`	源应用程序 id	动作 id
`InvokeEvent.arguments[2]`	null	NA

参数	iOS	Android
`InvokeEvent.arguments.length`	3	2
`InvokeEvent.arguments[0]`	url	url
`InvokeEvent.arguments[1]`	null	动作 id
`InvokeEvent.arguments[2]`	null	NA

参数	iOS
`InvokeEvent.arguments.length`	3
`InvokeEvent.arguments[0]`	url
`InvokeEvent.arguments[1]`	源应用程序 id
`InvokeEvent.arguments[2]`	注释

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

实现
public function get arguments():Array

currentDirectory

属性

currentDirectory:File [只读]

运行时版本:

AIR 1.0

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

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

实现
public function get currentDirectory():File

reason

属性

reason:String [只读]

运行时版本:

AIR 1.5.1

导致此 InvokeEvent 的原因。此属性表示，应用程序是由用户手动启动，还是在系统登录时自动启动。可能的值枚举为 InvokeEventReason 类中的常量：

InvokeEventReason 常量	意义
`LOGIN`	登录时自动启动。
`NOTIFICATION`	因响应通知而启动（仅 iOS）。
`OPEN_URL`	因该应用程序被另一个应用程序调用而启动。
`STANDARD`	由于其他原因而启动。

注意：在移动设备平台上，reason 属性始终不会设置为 LOGIN。

实现
public function get reason():String

相关 API 元素

flash.desktop.InvokeEventReason

构造函数详细信息

()

构造函数

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

语言版本:

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`) — 要传递给应用程序的参数（字符串）数组。

	`reason:String` (default = "`standard`") — 事件的原因：`InvokeEventReason.LOGIN`、`InvokeEventR ason.STANDARD`，`InvokeEventReason.OPEN_URL` 或 `InvokeEventReason.NOTIFICATION`。（此参数自 AIR 1.5.1 起可用。OPEN_URL 和 NOTIFICATION 自 AIR 3.5 起可用。）

相关 API 元素

flash.desktop.InvokeEventReason

方法详细信息

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 对象具有以下属性：

属性	值
`arguments`	在此调用过程中传递的字符串参数的数组。
`currentDirectory`	File 对象，表示解析 arguments 数组中的任何相对路径时应使用的目录。
`reason`	表示调用事件是否因以下原因而被调度的代码：登录时应用程序自动启动 (`InvokeEventReason.LOGIN`)，应用程序响应远程通知而启动（`InvokeEventReason.NOTIFICATION`，仅 iOS），应用程序被另一个应用程序调用 (`InvokeEventReason.OPEN_UR` )，其他原因 (`InvokeEventReason.STANDARD`)。从 AIR 1.5.1 版开始提供。
`bubbles`	`false`.
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	表示当前正在使用事件侦听器处理此 InvokeEvent 对象的对象。
`target`	始终是 NativeApplication 对象。

法律声明 | 在线隐私策略

InvokeEvent - AS3

包x

语言元素

附录

包 flash.events

arguments

currentDirectory

reason

InvokeEvent

clone

INVOKE