| 包 | flash.events |
| 类 | public class InvokeEvent |
| 继承 | InvokeEvent  Event Object |
| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 |
invoke 事件。
在启动应用程序时，NativeApplication 对象始终调度 invoke 事件，但也可以在其他时间调度此事件。例如，当用户激活与正在运行的应用程序关联的文件时，此应用程序将会调度另一个 InvokeEvent。
只能启动特定应用程序的单个实例。随后尝试启动该应用程序将导致由正在运行的实例的 NativeApplication 对象调度一个新的 invoke 事件。应用程序负责处理此事件并采取适当的动作，例如打开一个新应用程序窗口以显示文件中的数据。
InvokeEvent 由 NativeApplication 对象 (NativeApplication.nativeApplication) 调度。要接收 invoke 事件，请调用 NativeApplication 对象的 addEventListener() 方法。当某个事件侦听器针对 invoke 事件进行注册时，它还会接收到在注册前发生的所有 invoke 事件。这些先前的事件会在对 addEventListener() 的调用返回后（但并不一定在注册后可能调度的新 invoke 事件之前）进行调度。因此，不应依赖于调度顺序。
相关 API 元素
隐藏继承的公共属性
显示继承的公共属性| 属性 | 由以下参数定义 | ||
|---|---|---|---|
| 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 | ||
[覆盖]
创建此事件的新副本。 | InvokeEvent | ||
|
用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。 | Event | |
|
表示对象是否已经定义了指定的属性。 | Object | |
|
检查是否已对事件调用 preventDefault() 方法。 | Event | |
|
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
|
如果可以取消事件的默认行为，则取消该行为。 | Event | |
|
表示指定的属性是否存在、是否可枚举。 | Object | |
|
设置循环操作动态属性的可用性。 | Object | |
|
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。 | Event | |
|
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。 | Event | |
|
返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。 | Object | |
|
返回一个字符串，其中包含 Event 对象的所有属性。 | Event | |
|
返回指定对象的原始值。 | 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.length3 2 InvokeEvent.arguments[0]url url InvokeEvent.arguments[1]源应用程序 id 动作 id InvokeEvent.arguments[2]null NA - 系统调用应用程序以打开关联的文件类型（iOS 和 Android）：
参数 iOS Android InvokeEvent.arguments.length3 2 InvokeEvent.arguments[0]url url InvokeEvent.arguments[1]null 动作 id InvokeEvent.arguments[2]null NA - 另一个应用程序使用文档交互控制器调用该应用程序（仅 iOS）
参数 iOS InvokeEvent.arguments.length3 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 | 属性 |
reason | 属性 |
reason:String [只读] | 运行时版本: | AIR 1.5.1 |
导致此 InvokeEvent 的原因。此属性表示，应用程序是由用户手动启动，还是在系统登录时自动启动。可能的值枚举为 InvokeEventReason 类中的常量：
| InvokeEventReason 常量 | 意义 |
|---|---|
LOGIN | 登录时自动启动。 |
NOTIFICATION | 因响应通知而启动（仅 iOS）。 |
OPEN_URL | 因该应用程序被另一个应用程序调用而启动。 |
STANDARD | 由于其他原因而启动。 |
注意：在移动设备平台上，reason 属性始终不会设置为 LOGIN。
实现
public function get reason():String相关 API 元素
InvokeEvent | () | 构造函数 |
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)false。
| |
cancelable:Boolean (default = false)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 元素
clone | () | 方法 |
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 对象。 |
相关 API 元素
Tue Jun 12 2018, 11:04 AM Z