活动的应用程序窗口。

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

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

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

var appDescriptor:XML = NativeApplication.nativeApplication.applicationDescriptor;
var ns:Namespace = appDescriptor.namespace();
var appCopyright:String = appDescriptor.ns::copyright;
var appVersion:String = appDescriptor.ns::version;
trace("appId:", appCopyright);
trace("version:", appVersion);

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

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

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

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

应用程序图标。

使用 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 对象，则操作系统将选择大小最接近图标显示尺寸的图像，必要时缩放图像。

另请参见

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

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

另请参见

应用程序菜单。

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

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

另请参见

NativeApplication 对象的单一实例。

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

此应用程序的发布者 ID。

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

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

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

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

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

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

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

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

另请参见

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

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

另请参见

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

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

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

另请参见

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

另请参见

激活此应用程序。

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

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

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

激活操作是同步的。

参数

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

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

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

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

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

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

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

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

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

参数

function(evt:Event):void

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

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

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

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

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

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

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

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

参数

终止此应用程序。

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

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

参数

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

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

参数

另请参见

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

参数

另请参见

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

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

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

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

参数

另请参见

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

参数

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

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

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

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

参数

另请参见

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

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

此事件具有以下属性：

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

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

<allowBrowserInvocation>true</allowBrowserInvocation>

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

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

此事件具有以下属性：

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

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

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

此事件具有以下属性：

在调用应用程序时调度。

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

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

InvokeEvent 对象具有以下属性：

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

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

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

此事件具有以下属性：

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

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

此事件具有以下属性：

另请参见

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

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

此事件具有以下属性：

另请参见