flash.desktop.NativeApplication (Flex 3)

	属性	定义方
		activeWindow : NativeWindow [只读 (read-only)] 活动的应用程序窗口。	NativeApplication
		applicationDescriptor : XML [只读 (read-only)] 此 AIR 应用程序的应用程序描述符文件内容。	NativeApplication
		applicationID : String [只读 (read-only)] 此应用程序的应用程序 ID。	NativeApplication
		autoExit : Boolean 指定在关闭所有窗口后是否应自动终止应用程序。	NativeApplication
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		icon : InteractiveIcon [只读 (read-only)] 应用程序图标。	NativeApplication
		idleThreshold : int 在没有鼠标或键盘输入的情况下必须经过多少秒后才将调度 presenceChange 事件。	NativeApplication
		menu : NativeMenu 应用程序菜单。	NativeApplication
		nativeApplication : NativeApplication [静态] [只读 (read-only)] NativeApplication 对象的单一实例。	NativeApplication
		openedWindows : Array [只读 (read-only)] 包含此应用程序的所有已打开的本机窗口的数组。	NativeApplication
		prototype : Object [静态] 对类或函数对象的原型对象的引用。	Object
		publisherID : String [只读 (read-only)] 此应用程序的发布者 ID。	NativeApplication
		runtimePatchLevel : uint [只读 (read-only)] 承载此应用程序的运行时的修补级别。	NativeApplication
		runtimeVersion : String [只读 (read-only)] 承载此应用程序的运行时的版本号。	NativeApplication
		startAtLogin : Boolean 指定在当前用户登录时是否自动启动此应用程序。	NativeApplication
		supportsDockIcon : Boolean [静态] [只读 (read-only)] 指示 AIR 是否支持当前操作系统上的应用程序停靠图标。	NativeApplication
		supportsMenu : Boolean [静态] [只读 (read-only)] 指定当前操作系统是否支持全局应用程序菜单栏。	NativeApplication
		supportsSystemTrayIcon : Boolean [静态] [只读 (read-only)] 指定 AIR 是否支持当前操作系统上的系统任务栏图标。	NativeApplication
		timeSinceLastUserInput : int [只读 (read-only)] 自上次鼠标或键盘输入后经过的时间（以秒为单位）。	NativeApplication

	方法	定义方
		activate(window:NativeWindow = null):void 激活此应用程序。	NativeApplication
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	NativeApplication
		clear():Boolean 在具有焦点的显示对象上调用一个内部删除命令。	NativeApplication
		copy():Boolean 在具有焦点的显示对象上调用一个内部复制命令。	NativeApplication
		cut():Boolean 在具有焦点的显示对象上调用一个内部剪切命令。	NativeApplication
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	NativeApplication
		exit(errorCode:int = 0):void 终止此应用程序。	NativeApplication
		getDefaultApplication(extension:String):String 获取用于打开具有指定扩展名的文件的默认应用程序。	NativeApplication
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		isSetAsDefaultApplication(extension:String):Boolean 指定此应用程序当前是否为打开具有指定扩展名的文件的默认应用程序。	NativeApplication
		paste():Boolean 在具有焦点的显示对象上调用一个内部粘贴命令。	NativeApplication
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		removeAsDefaultApplication(extension:String):void 撤消将此应用程序作为打开具有指定扩展名的文件的默认应用程序。	NativeApplication
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	NativeApplication
		selectAll():Boolean 在具有焦点的显示对象上调用一个内部全选命令。	NativeApplication
		setAsDefaultApplication(extension:String):void 将此应用程序设置为打开具有指定扩展名的文件的默认应用程序。	NativeApplication
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。	EventDispatcher

摘要	定义方
activate	当此应用程序变为活动桌面应用程序时调度。	NativeApplication
deactivate	将桌面焦点切换到不同的应用程序时调度。	NativeApplication
exiting	在启动应用程序的退出序列时调度。	NativeApplication
invoke	在调用应用程序时调度。	NativeApplication
networkChange	当新的网络连接变为可用或现有网络连接中断时调度。	NativeApplication
userIdle	当用户处于空闲状态的时间长度达到 idleThreshold 属性指定的时间时调度。	NativeApplication
userPresent	当操作系统在空闲一段时间后检测到鼠标或键盘活动时调度。	NativeApplication

属性详细信息

activeWindow

属性

activeWindow:NativeWindow [只读 (read-only)]

活动的应用程序窗口。

如果活动的桌面窗口不属于此应用程序，则 activeWindow 为 null。

applicationDescriptor

属性

applicationDescriptor:XML [只读 (read-only)]

此 AIR 应用程序的应用程序描述符文件内容。

SWF 文件中的 ActionScript 3.0 代码支持用于处理 XML 数据的 E4X 语法。但在基于 HTML 的 AIR 应用程序中，需要使用 DOMParser 对象的 parseFromString() 方法将此属性的 XML 值转换为 DOMParser 对象。

示例

下例检测应用程序描述符文件中的 copyright 和 version 属性。

注意：要测试此示例，请执行以下操作：

将 AIRAliases.js 文件添加到项目目录。
为该项目创建应用程序描述符文件，并使用 ADL 测试该项目。

<html>
    <head>
      <script src="AIRAliases.js" />
      <script>
        function getInfo() {
            var xmlString = air.NativeApplication.nativeApplication.applicationDescriptor;
            var appXml = new DOMParser();
            var xmlObject = appXml.parseFromString(xmlString, "text/xml");
            var root = xmlObject.getElementsByTagName('application')[0];
            var appCopyright = root.getElementsByTagName("copyright")[0];
            var appVersion = root.getElementsByTagName("version")[0];
            air.trace("copyright:", appCopyright.firstChild.data);
            air.trace("version:", appVersion.firstChild.data);
        }
      </script>
    </head>
    <body>
        <button onclick="getInfo()">Get Info</button>
    </body>
</html>

applicationID

属性

applicationID:String [只读 (read-only)]

此应用程序的应用程序 ID。

此 ID 的值在应用程序描述符文件中设置。

autoExit

属性

autoExit:Boolean [读写]

指定在关闭所有窗口后是否应自动终止应用程序。

当 autoExit 为 true（默认值）时，如果关闭了所有窗口，则应用程序将终止。调度 exiting 和 exit 事件。如果 autoExit 为 false，则必须调用 NativeApplication.nativeApplication.exit() 才能终止应用程序。

icon

属性

icon:InteractiveIcon [只读 (read-only)]

应用程序图标。

使用 NativeApplication.supportsDockIcon 和 NativeApplication.supportsSystemTrayIcon 可确定 icon 类。类型将是 InteractiveIcon 的子类之一。在 Mac^® OS X 上，NativeApplication.icon 是一个类型为 DockIcon 的对象。在 Windows^® 上，NativeApplication.icon 是一个类型为 SystemTrayIcon 的对象。

icon 对象是自动创建的，但不会使用图像数据自动初始化此对象。有些操作系统（如 Mac OS X）提供默认图像。在其他操作系统中（如 Windows），除非为图标分配了图像数据，否则不显示图标。若要分配图标图像，请使用包含至少一个 BitmapData 对象的数组来设置 icon.bitmaps 属性。如果数组中包括多个 BitmapData 对象，则操作系统将选择大小最接近图标显示尺寸的图像，必要时缩放图像。

另请参见

supportsDockIcon
DockIcon
supportsSystemTrayIcon
SystemTrayIcon

idleThreshold

属性

idleThreshold:int [读写]

在没有鼠标或键盘输入的情况下必须经过多少秒后才将调度 presenceChange 事件。

默认情况下，空闲阈值为 300 秒（5 分钟）。

另请参见

userIdle
userPresent

属性

menu:NativeMenu [读写]

应用程序菜单。

当 NativeApplication.nativeApplication.supportsMenu 为 true 时支持应用程序菜单。不是所有操作系统都支持应用程序菜单。例如，Mac OS X 支持应用程序菜单，但 Windows 不支持。允许在 NativeApplication.nativeApplication.supportsMenu 为 false 时将 NativeMenu 对象分配给此属性，但不执行任何操作。

注意：在 Mac OS X 中，menu 属性引用操作系统提供的默认应用程序菜单。您可以通过添加和删除项目、子菜单以及添加事件侦听器来修改现有菜单结构。也可以通过将新 NativeMenu 对象分配给此 menu 属性来完全替换默认菜单。

另请参见

NativeMenu
NativeWindow.supportsMenu

nativeApplication

属性

nativeApplication:NativeApplication [只读 (read-only)]

NativeApplication 对象的单一实例。

引发

Error — 如果由应用程序安全沙箱外部的内容访问。

openedWindows

属性

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

包含此应用程序的所有已打开的本机窗口的数组。

publisherID

属性

publisherID:String [只读 (read-only)]

此应用程序的发布者 ID。

此 ID 的值在应用程序发布者 ID 文件中设置，该文件在安装时从用于对应用程序签名的证书链中生成。

runtimePatchLevel

属性

runtimePatchLevel:uint [只读 (read-only)]

承载此应用程序的运行时的修补级别。

runtimeVersion

属性

runtimeVersion:String [只读 (read-only)]

承载此应用程序的运行时的版本号。

startAtLogin

属性

startAtLogin:Boolean [读写]

指定在当前用户登录时是否自动启动此应用程序。

startAtLogin 属性反映操作系统定义用于指定某个应用程序应该在用户登录时自动启动的机制的状态。用户可以使用操作系统的用户界面手动更改该状态。不管该状态上次是由 AIR 应用程序进行修改还是由操作系统进行更改，此属性都将反映当前状态。

引发

	`IllegalOperationError` — 在 Windows 上，如果已经设置了另一个同名（但可执行文件的路径不同）的应用程序在此用户登录时启动。

	`IllegalOperationError` — 如果未安装此应用程序（由 AIR Debug Launcher (ADL) 启动就属于这种情况）。

supportsDockIcon

属性

supportsDockIcon:Boolean [只读 (read-only)]

指示 AIR 是否支持当前操作系统上的应用程序停靠图标。

如果为 true，则 NativeApplication.icon 属性的类型为 DockIcon。

Mac OS X 和各种 Linux^® 用户界面提供应用程序停靠，其中包含正在运行或频繁使用的应用程序的图标。

另请参见

icon

supportsMenu

属性

supportsMenu:Boolean [只读 (read-only)]

指定当前操作系统是否支持全局应用程序菜单栏。

如果为 true，则可以使用 NativeApplication.menu 属性来定义（或访问）本机应用程序菜单。

另请参见

menu
NativeWindow.supportsMenu

supportsSystemTrayIcon

属性

supportsSystemTrayIcon:Boolean [只读 (read-only)]

指定 AIR 是否支持当前操作系统上的系统任务栏图标。

如果为 true，则 NativeApplication.icon 属性的类型为 SystemTrayIcon。

注意：在 Windows 上，任务栏的系统任务栏区域正式称为通知区域。

另请参见

icon

timeSinceLastUserInput

属性

timeSinceLastUserInput:int [只读 (read-only)]

自上次鼠标或键盘输入后经过的时间（以秒为单位）。

另请参见

userIdle
userPresent

方法详细信息

activate

()

方法

function activate(window:NativeWindow = null):void

激活此应用程序。

在由操作系统确定的某些情况下，此方法将不会激活应用程序。多数操作系统都限制应用程序自行激活的能力，以避免意外或恶意地使用户无法使用其他应用程序。

如果操作系统允许激活，则激活指定的窗口并将其放到桌面的前景；即放在其他应用程序窗口的前面。（如果 window 参数为 null，则激活此应用程序的可视窗口。）

如果应用程序没有可视窗口，则 activate() 方法没有任何效果。

激活操作是同步的。

参数

window:NativeWindow (default = null) — 要与应用程序一起激活的窗口的 NativeWindow 对象。

事件

activate:Event — 激活状态更改时调度。

addEventListener

()

方法

  function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void

使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。可以为特定类型的事件、阶段和优先级在显示列表的所有节点上注册事件侦听器。

AIR 运行时中的 JavaScript 代码使用此方法注册 AIR API 定义的事件的事件侦听器。对于其它 JavaScript 事件（如 DOM body 对象的 onload 事件），您可以像对浏览器中运行的内容一样使用标准事件处理技术。

成功注册一个事件侦听器后，无法通过额外调用 addEventListener() 来更改其优先级。要更改侦听器的优先级，必须首先调用 removeListener()。然后，可以使用新的优先级再次注册该侦听器。

请记住，注册该侦听器后，如果继续调用具有不同 type 或 useCapture 值的 addEventListener()，则会创建单独的侦听器注册。例如，如果首先注册 useCapture 设置为 true 的侦听器，则该侦听器只在捕获阶段进行侦听。如果使用同一个侦听器对象再次调用 addEventListener()，并将 useCapture 设置为 false，那么便会拥有两个单独的侦听器：一个在捕获阶段进行侦听，另一个在目标和冒泡阶段进行侦听。

不能只为目标阶段或冒泡阶段注册事件侦听器。这些阶段在注册期间是成对出现的，因为冒泡阶段只适用于目标节点的始祖。

如果不再需要某个事件侦听器，可调用 removeEventListener() 删除它，否则会产生内存问题。由于垃圾回收器不会删除仍包含引用的对象，因此不会从内存中自动删除使用已注册事件侦听器的对象。

复制 EventDispatcher 实例时并不复制其中附加的事件侦听器。（如果新近创建的节点需要一个事件侦听器，必须在创建该节点后附加该侦听器。）但是，如果移动 EventDispatcher 实例，则其中附加的事件侦听器也会随之移动。

如果在正在处理事件的节点上注册事件侦听器，则不会在当前阶段触发事件侦听器，但会在事件流的稍后阶段触发，如冒泡阶段。

如果从正在处理事件的节点中删除事件侦听器，则该事件侦听器仍由当前操作触发。删除事件侦听器后，决不会再次调用该事件侦听器（除非再次注册以备将来处理）。

参数

	`type:String` — 事件的类型。

	`listener:Function` — 处理事件的侦听器函数。此函数必须接受 Event 对象作为其唯一的参数，并且不能返回任何结果，如下面的示例所示：。 function(evt:Event):void 函数可以有任何名称。

	`useCapture:Boolean` (default = `false`) — 此参数适用于 SWF 内容所使用的 ActionScript 3.0 显示列表体系结构中的显示对象。确定侦听器是运行于捕获阶段、目标阶段还是冒泡阶段。如果将 `useCapture` 设置为 `true`，则侦听器只在捕获阶段处理事件，而不在目标或冒泡阶段处理事件。如果 `useCapture` 为 `false`，则侦听器只在目标或冒泡阶段处理事件。要在所有三个阶段都侦听事件，请调用 `addEventListener` 两次：一次将 `useCapture` 设置为 `true`，一次将 `useCapture` 设置为 `false`。

	`priority:int` (default = `0`) — 事件侦听器的优先级。优先级由一个带符号的 32 位整数指定。数字越大，优先级越高。优先级为 n 的所有侦听器会在优先级为 n -1 的侦听器之前得到处理。如果两个或更多个侦听器共享相同的优先级，则按照它们的添加顺序进行处理。默认优先级为 0。

	`useWeakReference:Boolean` (default = `false`) — 确定对侦听器的引用是强引用，还是弱引用。强引用（默认值）可防止您的侦听器被当作垃圾回收。弱引用则没有此作用。类级别成员函数不属于垃圾回收的对象，因此可以对类级别成员函数将 `useWeakReference` 设置为 `true` 而不会使它们受垃圾回收的影响。如果对作为嵌套内部函数的侦听器将 `useWeakReference` 设置为 `true`，则该函数将作为垃圾回收并且不再是永久函数。如果创建对该内部函数的引用（将该函数保存到另一个变量中），则该函数将不作为垃圾回收并仍将保持永久。

clear

()

方法

function clear():Boolean

在具有焦点的显示对象上调用一个内部删除命令。

如果具有焦点的对象不实现该命令，则将忽略此函数调用。只有源于 TextField 或 HTMLLoader 类的显示对象当前实现此命令。

注意：clear() 命令会删除所选的文本。如果未选择任何内容，则不会清除所有文本。

Boolean — true.

copy

()

方法

function copy():Boolean

在具有焦点的显示对象上调用一个内部复制命令。

如果组件不实现该命令，则将忽略此函数调用。只有源于 TextField 或 HTMLLoader 类的显示对象当前实现此命令。

Boolean

cut

()

方法

function cut():Boolean

在具有焦点的显示对象上调用一个内部剪切命令。

如果组件不实现该命令，则将忽略此函数调用。只有源于 TextField 或 HTMLLoader 类的显示对象当前实现此命令。

Boolean — true.

dispatchEvent

()

方法

function dispatchEvent(event:Event):Boolean

将事件调度到事件流中。事件目标是对其调用 dispatchEvent() 方法的 EventDispatcher 对象。

参数

event:Event — 调度到事件流中的 Event 对象。如果正在重新调度事件，则会自动创建此事件的一个克隆。在调度了事件后，其 target 属性将无法更改，因此您必须创建此事件的一个新副本以能够重新调度。

Boolean — 如果成功调度了事件，则值为 true。值 false 表示失败或对事件调用了 preventDefault()。

exit

()

方法

function exit(errorCode:int = 0):void

终止此应用程序。

对 exit() 方法的调用将会返回；只有在当前正在执行的代码（比如当前的事件处理函数）完成后，关机序列才会开始。未处理的异步操作将被取消，可能完成，也可能未完成。

请注意，不会调度 exiting 事件。如果应用程序逻辑需要 exiting 事件，请调用 NativeApplication.nativeApplication.dispatchEvent()，并传入一个类型为 exiting 的 Event 对象。同样，在关闭应用程序窗口之前，不会调度 closing 和 close 事件。如果在应用程序退出之前应该通知各个窗口，则可以为每个打开的窗口调度 closing 事件。如果需要窗口的 close 事件，请在退出之前调用该窗口的 close() 方法。

参数

errorCode:int (default = 0) — 此应用程序退出时报告给操作系统的退出代码。

getDefaultApplication

()

方法

function getDefaultApplication(extension:String):String

获取用于打开具有指定扩展名的文件的默认应用程序。

注意：此方法只能用于在应用程序描述符的 fileTypes 语句中声明的文件类型。

参数

extension:String — 包含需要关注的文件类型扩展名的 String（不带“.”）。

String — 默认应用程序的路径。

引发

Error — 如果 extension 参数不包含在应用程序描述符中声明的文件扩展名之一。

另请参见

applicationDescriptor

isSetAsDefaultApplication

()

方法

function isSetAsDefaultApplication(extension:String):Boolean

指定此应用程序当前是否为打开具有指定扩展名的文件的默认应用程序。

参数

extension:String — 包含需要关注的文件类型扩展名的 String（不带“.”）。

Boolean — 如果此应用程序是默认的应用程序，则为 true。

引发

Error — 如果 extension 参数不包含在应用程序描述符中声明的文件扩展名之一。

另请参见

applicationDescriptor

paste

()

方法

function paste():Boolean

在具有焦点的显示对象上调用一个内部粘贴命令。

如果组件不实现该命令，则将忽略此函数调用。只有源于 TextField 或 HTMLLoader 类的显示对象当前实现此命令。

Boolean — true.

removeAsDefaultApplication

()

方法

function removeAsDefaultApplication(extension:String):void

撤消将此应用程序作为打开具有指定扩展名的文件的默认应用程序。

注意：此方法只能用于在应用程序描述符的 fileTypes 语句中列出的文件类型。

参数

extension:String — 包含需要关注的文件类型扩展名的 String（不带“.”）。

引发

Error — 如果 extension 参数不包含在应用程序描述符中声明的文件扩展名之一。

另请参见

applicationDescriptor

removeEventListener

()

方法

function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void

从 EventDispatcher 对象中删除侦听器。如果没有向 EventDispatcher 对象注册任何匹配的侦听器，则对此方法的调用没有任何效果。

参数

	`type:String` — 事件的类型。

	`listener:Function` — 要删除的侦听器对象。

	`useCapture:Boolean` (default = `false`) — 此参数适用于 SWF 内容所使用的 ActionScript 3.0 显示列表体系结构中的显示对象。指出是否为捕获阶段或目标阶段和冒泡阶段注册了侦听器。如果为捕获阶段以及目标和冒泡阶段注册了侦听器，则需要对 `removeEventListener()` 进行两次调用才能将这两个侦听器删除，一次调用将 `useCapture()` 设置为 `true`，另一次调用将 `useCapture()` 设置为 `false`。

selectAll

()

方法

function selectAll():Boolean

在具有焦点的显示对象上调用一个内部全选命令。

如果组件不实现该命令，则将忽略此函数调用。只有源于 TextField 或 HTMLLoader 类的显示对象当前实现此命令。

Boolean — true.

setAsDefaultApplication

()

方法

function setAsDefaultApplication(extension:String):void

将此应用程序设置为打开具有指定扩展名的文件的默认应用程序。

注意：此方法只能用于在应用程序描述符的 fileTypes 语句中声明的文件类型。

参数

extension:String — 包含需要关注的文件类型扩展名的 String（不带“.”）。

引发

Error — 如果 extension 参数不包含在应用程序描述符中声明的文件扩展名之一。

另请参见

applicationDescriptor

事件详细信息

activate

事件

事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.ACTIVATE

当此应用程序变为活动桌面应用程序时调度。

Event.ACTIVATE 常量定义 activate 事件对象的 type 属性值。

注意：无论目标是否出现在显示列表中，此事件都不会通过“捕获阶段”，而是被直接调度给此目标。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	具有为 ACTIVATE 事件注册的侦听器的任何 DisplayObject 实例。

deactivate

事件

事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.DEACTIVATE

将桌面焦点切换到不同的应用程序时调度。

Event.DEACTIVATE 常量定义 deactivate 事件对象的 type 属性值。

注意：无论目标是否出现在显示列表中，此事件都不会通过“捕获阶段”，而是被直接调度给此目标。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	具有为 DEACTIVATE 事件注册的侦听器的任何 DisplayObject 实例。

exiting

事件

事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.EXITING

在启动应用程序的退出序列时调度。

当操作系统启动应用程序退出序列时将调度 exiting 事件，例如，当用户在 Mac OS X 上发出 Cmd-Q 键序列，或当 NativeApplication 对象的 autoExit 属性为 true 且关闭最后一个应用程序窗口时。取消此事件将阻止应用程序退出。

注意：调用 NativeApplication 的exit() 方法不会导致调度 exiting 事件。若要在退出前警告各个组件，请在调用 exit() 之前调度 exiting 事件

Event.EXITING 常量定义 exiting 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`true`；取消此事件对象将停止退出操作。
`currentTarget`	NativeApplication 对象。
`target`	NativeApplication 对象。

invoke

事件

事件对象类型: flash.events.InvokeEvent
属性 InvokeEvent.type = flash.events.InvokeEvent.INVOKE

在调用应用程序时调度。

第二次调用某个应用程序时，不会启动该应用程序的另一个实例。第一个实例将接收附加的 invoke 事件。应用程序负责适当地处理随后的 invoke 事件。

注意：所有 invoke 事件都排队处理。如果为此事件注册了侦听器，该侦听器将接收队列中的所有事件以及任何新事件。排队的事件可以在任何新的 invoke 事件之前或之后传送。

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

InvokeEvent 对象具有以下属性：

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

networkChange

事件

事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.NETWORK_CHANGE

当新的网络连接变为可用或现有网络连接中断时调度。

networkChange 事件并不一定意味着主机已经联机或脱机；它可能只是从一种类型的连接过渡到另一种类型的连接。应用程序可以使用此事件来帮助优化监视远程资源可用性的任务。调度 networkChange 事件之时往往是验证任何远程资源可用性的绝佳时机。

注意：在网络更改和传送此事件之间可能有短时间的延迟。

Event.NETWORK_CHANGE 常量定义 networkChange 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	NativeApplication 对象。

userIdle

事件

事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.USER_IDLE

当用户处于空闲状态的时间长度达到 idleThreshold 属性指定的时间时调度。

用户已经处于空闲状态的时间可以从 timeSinceLastUserInput 属性确定。

Event.USER_IDLE 常量定义 userIdle 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`target`	NativeApplication 对象。

另请参见

idleThreshold
timeSinceLastUserInput

userPresent

事件

事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.USER_PRESENT

当操作系统在空闲一段时间后检测到鼠标或键盘活动时调度。

视为空闲的时间段可以使用 idleThreshold 属性来配置。用户已经处于空闲状态的时间可以从 timeSinceLastUserInput 属性确定。

Event.USER_PRESENT 常量定义 userPresent 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`target`	NativeApplication 对象。

另请参见

idleThreshold
timeSinceLastUserInput

window.runtime 属性	window.runtime.flash.desktop.NativeApplication

继承	NativeApplication EventDispatcher Object

针对 HTML 开发人员的 Adobe AIR 语言参考	索引 \| 框架无框架
NativeApplication