flash.desktop.NativeApplication

	属性	定义方
		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 在没有键盘或鼠标输入的情况下必须经过多少秒才会调度 userIdle 事件。	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 [override] 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	NativeApplication
		clear():Boolean 在具有焦点的显示对象上调用一个内部删除命令。	NativeApplication
		copy():Boolean 在具有焦点的显示对象上调用一个内部复制命令。	NativeApplication
		cut():Boolean 在具有焦点的显示对象上调用一个内部剪切命令。	NativeApplication
		dispatchEvent(event:Event):Boolean [override] 将事件调度到事件流中。	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 [override] 从 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
browserInvoke	用户浏览器中运行的 SWF 文件调用应用程序时将调度此事件。	NativeApplication
deactivate	将桌面焦点切换到不同的应用程序时调度。	NativeApplication
exiting	在启动应用程序的退出序列时调度。	NativeApplication
invoke	在调用应用程序时调度。	NativeApplication
networkChange	当新的网络连接变为可用或现有网络连接中断时调度。	NativeApplication
userIdle	当用户处于空闲状态的时间长度达到 idleThreshold 属性指定的时间时调度。	NativeApplication
userPresent	当操作系统在空闲一段时间后检测到鼠标或键盘活动时调度。	NativeApplication

属性详细信息

activeWindow

属性

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

运行时版本:

1.0

活动的应用程序窗口。

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

applicationDescriptor

属性

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

运行时版本:

1.0

此 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)]

运行时版本:

1.0

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

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

autoExit

属性

autoExit:Boolean

运行时版本:

1.0

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

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

icon

属性

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

运行时版本:

1.0

应用程序图标。

使用 NativeApplication.supportsDockIcon 和 NativeApplication.supportsSystemTrayIcon 可确定 icon 类。类型将是 InteractiveIcon 的子类之一。在 Mac^® OS X 上，NativeApplication.icon 是一个类型为 DockIcon 的对象。在 Windows^® 上，NativeApplication.icon 是一个类型为 SystemTrayIcon 的对象。在 Linux 中，并非始终支持应用程序图标。在这种情况下，icon 属性为 null。

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

另请参见

supportsDockIcon
DockIcon
supportsSystemTrayIcon
SystemTrayIcon

idleThreshold

属性

idleThreshold:int

运行时版本:

1.0

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

默认情况下，空闲阈值为 300 秒（5 分钟）。值的可接受范围为 5（5 秒）到 86,400（1 天），这两个值自身包括在内。

引发

ArgumentError — 如果尝试设置此属性，它将设置为一个无效值。值的可接受范围为 5（5 秒）到 86,400（1 天），这两个值自身包括在内。

另请参见

userIdle
userPresent

属性

menu:NativeMenu

运行时版本:

1.0

应用程序菜单。

当 NativeApplication.nativeApplication.supportsMenu 为 true 时支持应用程序菜单。不是所有操作系统都支持应用程序菜单。例如，Mac OS X 支持应用程序菜单，但 Windows 或 Linux 不支持。允许在 NativeApplication.nativeApplication.supportsMenu 为 false 时将 NativeMenu 对象分配给此属性，但不执行任何操作。务必使用 NativeApplication.nativeApplication.supportsMenu 属性来确定操作系统是否支持应用程序菜单。使用其它方法（如 Capabilities.os）确定支持情况可能导致编程错误（如果没有考虑到某些可行的目标操作系统）。

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

另请参见

NativeMenu
NativeWindow.supportsMenu

nativeApplication

属性

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

运行时版本:

1.0

NativeApplication 对象的单一实例。

引发

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

openedWindows

属性

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

运行时版本:

1.0

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

publisherID

属性

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

运行时版本:

1.0

此应用程序的发布者 ID。

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

runtimePatchLevel

属性

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

运行时版本:

1.0

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

runtimeVersion

属性

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

运行时版本:

1.0

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

startAtLogin

属性

startAtLogin:Boolean

运行时版本:

1.0

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

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

引发

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

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

supportsDockIcon

属性

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

运行时版本:

1.0

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

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

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

务必使用 NativeApplication.supportsDockIcon 属性来确定操作系统是否支持应用程序停靠图标。使用其它方法（如 Capabilities.os）确定支持情况可能导致编程错误（如果没有考虑到某些可行的目标操作系统）。

另请参见

icon

supportsMenu

属性

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

运行时版本:

1.0

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

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

务必使用 NativeApplication.supportsMenu 属性来确定操作系统是否支持应用程序菜单栏。使用其它方法（如 Capabilities.os）确定支持情况可能导致编程错误（如果没有考虑到某些可行的目标操作系统）。

另请参见

menu
NativeWindow.supportsMenu

supportsSystemTrayIcon

属性

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

运行时版本:

1.0

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

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

务必使用 NativeApplication.supportsSystemTrayIcon 属性来确定操作系统是否支持系统任务栏图标。使用其它方法（如 Capabilities.os）确定支持情况可能导致编程错误（如果没有考虑到某些可行的目标操作系统）。

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

另请参见

icon

timeSinceLastUserInput

属性

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

运行时版本:

1.0

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

另请参见

userIdle
userPresent

方法详细信息

activate

()

方法

function activate(window:NativeWindow = null):void

运行时版本:

1.0

激活此应用程序。

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

如果操作系统允许激活，则激活指定的窗口并将其放到桌面的前景；即放在其他应用程序窗口的前面。（如果 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

运行时版本:

1.0

使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。

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

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

请记住，注册该侦听器后，如果继续调用具有不同 type 或 useCapture 值的 addEventListener()，则会创建单独的侦听器注册。

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

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

参数

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

	`listener:Function` — 处理事件的侦听器函数。此函数必须接受 Event 对象作为其唯一的参数并且不能返回任何结果。函数可以有任何名称。

	`useCapture:Boolean` (default = `false`) — 此参数适用于 SWF 内容所使用的 ActionScript 3.0 显示列表体系结构中的显示对象。

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

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

clear

()

方法

function clear():Boolean

运行时版本:

1.0

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

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

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

Boolean — true.

copy

()

方法

function copy():Boolean

运行时版本:

1.0

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

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

Boolean

cut

()

方法

function cut():Boolean

运行时版本:

1.0

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

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

Boolean — true.

dispatchEvent

()

方法

function dispatchEvent(event:Event):Boolean

运行时版本:

1.0

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

参数

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

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

exit

()

方法

function exit(errorCode:int = 0):void

运行时版本:

1.0

终止此应用程序。

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

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

参数

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

getDefaultApplication

()

方法

function getDefaultApplication(extension:String):String

运行时版本:

1.0

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

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

参数

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

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

引发

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

另请参见

applicationDescriptor

isSetAsDefaultApplication

()

方法

function isSetAsDefaultApplication(extension:String):Boolean

运行时版本:

1.0

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

参数

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

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

引发

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

另请参见

applicationDescriptor

paste

()

方法

function paste():Boolean

运行时版本:

1.0

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

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

Boolean — true.

removeAsDefaultApplication

()

方法

function removeAsDefaultApplication(extension:String):void

运行时版本:

1.0

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

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

参数

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

引发

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

另请参见

applicationDescriptor

removeEventListener

()

方法

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

运行时版本:

1.0

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

参数

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

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

	`useCapture:Boolean` (default = `false`) — 此参数适用于 SWF 内容所使用的 ActionScript 3.0 显示列表体系结构中的显示对象。

selectAll

()

方法

function selectAll():Boolean

运行时版本:

1.0

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

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

Boolean — true.

setAsDefaultApplication

()

方法

function setAsDefaultApplication(extension:String):void

运行时版本:

1.0

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

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

参数

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

引发

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

另请参见

applicationDescriptor

事件详细信息

activate

事件

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

运行时版本:

1.0

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

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

注意：此事件既不具有“捕获阶段”也不具有“冒泡阶段”，这意味着必须直接将事件侦听器添加到任何潜在的目标，而无论目标是否位于显示列表中。

此事件具有以下属性：

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

browserInvoke

事件

事件对象类型: flash.events.BrowserInvokeEvent
属性 BrowserInvokeEvent.type = flash.events.BrowserInvokeEvent.Browser_INVOKE

运行时版本:

1.0

用户浏览器中运行的 SWF 文件调用应用程序时将调度此事件。

只有当应用程序在应用程序描述符文件中指定如下内容时才允许浏览器调用：

<allowBrowserInvocation>true</allowBrowserInvocation>

deactivate

事件

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

运行时版本:

1.0

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

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

此事件具有以下属性：

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

exiting

事件

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

运行时版本:

1.0

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

当操作系统启动应用程序退出序列时将调度 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

运行时版本:

1.0

在调用应用程序时调度。

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

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

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

InvokeEvent 对象具有以下属性：

属性	值
`arguments`	在此调用过程中传递的字符串参数的数组。
`currentDirectory`	一个File 对象，表示解析 arguments 数组中的任何相对路径时应使用的目录。
`reason`	指示 invoke 事件调度原因的代码，原因可能是应用程序在系统登录时自动启动 (`InvokeEventReason.LOGIN`)，或是其它原因 (`InvokeEventReason.STANDARD`)。从 AIR 1.5.1 版开始提供。
`bubbles`	`false`.
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	指示当前正在使用事件侦听器处理此 InvokeEvent 对象的对象。
`target`	始终为NativeApplication 对象。

networkChange

事件

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

运行时版本:

1.0

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

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

运行时版本:

1.0

当用户处于空闲状态的时间长度达到 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

运行时版本:

1.0

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

视为空闲的时间段可以使用 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 开发人员的 AIR 语言参考
NativeApplication