NativeApplication  - AS3

活动的应用程序窗口。

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

不支持 NativeWindow 类的平台不支持此属性。

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

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() 才能终止应用程序。

不支持 NativeWindow 类的平台不支持此属性。

指定应用程序是否将在后台运行。

如果 executeInBackground 为 false（此为默认值），则应用程序进入后台时将保持暂停状态。如果 executeInBackground 为 true，则应用程序会在后台运行。

注意：对于 SWF 21 及其之前的版本，当渲染模式设置为“direct”时，AIR 在 iOS 和 Android 上不支持后台执行。由于这一限制，基于 Stage3D 的应用程序无法执行如音频播放、位置更新、网络上传或下载等后台任务。iOS 不允许在后台进行 OpenGLES 或渲染调用。试图在后台进行 OpenGL 调用的应用程序会被 iOS 终止。Android 并不限制应用程序在后台进行 OpenGLES 调用或执行其他后台任务（如音频播放）。对于 SWF 22 及其之后的版本，当 renderMode 设置为“direct”时，AIR 移动设备应用程序可以在后台执行。如果是在后台进行 OpenGLES 调用，则 AIR iOS 运行时会导致 ActionScript 错误（3768 - 不可以在后台执行期间使用 Stage3D API）。不过，在 Android 上不会导致错误，原因是允许其本机应用程序在后台进行 OpenGLES 调用。若想对移动设备资源的利用达到最佳效果，当应用程序在后台执行时，不要进行渲染调用。

AIR iOS 和 Android 支持此属性。

应用程序图标。

使用 NativeApplication.supportsDockIcon 和 NativeApplication.supportsSystemTrayIcon 可确定 icon 类。类型将是 InteractiveIcon 的子类之一。在 Mac^® OS X 上，NativeApplication.icon 是一个类型为 DockIcon 的对象。在 Windows^® 上，NativeApplication.icon 是一个类型为 SystemTrayIcon 的对象。如果不支持应用程序图标，则 NativeApplication.supportsDockIcon 和 NativeApplication.supportsSystemTrayIcon 均为 false，并且 icon 属性为 null。

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

相关 API 元素

在调度 userIdle 事件之前无用户输入状态必须持续的秒数。

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

相关 API 元素

指定是否针对所需平台编译或解释应用程序。对于 targets(ipa-app-store, ipa-test, ipa-debug, ipa-ad-hoc)，此 API 仅针对 iOS 返回 (true)。对于其他 AIR 平台，此 API 返回 (false)。

应用程序菜单。

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

AIR 配置文件支持：移动设备或 AIR for TV 设备不支持此功能。有关在多个配置文件之间支持 API 的详细信息，请参阅 AIR 配置文件支持。

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

相关 API 元素

NativeApplication 对象的单一实例。

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

不支持 NativeWindow 类的平台不支持此属性。

此应用程序的发布者 ID。

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

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

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

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

AIR 配置文件支持：所有桌面操作系统均支持此功能，但移动设备或 AIR for TV 设备不支持此功能。您可以使用 NativeApplication.supportsStartAtLogin 属性在运行时测试是否受支持。有关在多个配置文件之间支持 API 的详细信息，请参阅 AIR 配置文件支持。

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

相关 API 元素

表示当前平台是否支持 setAsDefaultApplication()、removeAsDefaultApplication() 和 isSetAsDefaultApplication()。

如果为 true，则上述方法将按预定操作。如果为 false，则 setAsDefaultApplication() 和 removeDefaultApplication() 不执行任何操作，isSetAsDefaultApplication() 将返回 false。

相关 API 元素

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

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

Mac OS X 用户界面提供了一个应用程序“停靠栏”，其中包含正在运行或常用的应用程序的图标。

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

相关 API 元素

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

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

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

相关 API 元素

表示当前平台是否支持 startAtLogin。

如果为 true，startAtLogin 将按预定操作。如果为 false，startAtLogin 不起作用。

相关 API 元素

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

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

Windows 用户界面提供任务栏的“系统托盘”区域，它的正式名称为通知区域，在其中可以显示应用程序图标。不显示默认图标。必须设置图标对象的 bitmaps 数组才能显示图标。

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

相关 API 元素

为应用程序提供一种防止用户界面进入“空闲”模式的方法。

SystemIdleMode 类的值，可影响主机系统的空闲模式行为。此属性仅对具有输入焦点的应用程序有效，只能从应用程序沙箱中运行的内容访问。

AIR 配置文件支持：移动设备支持此功能，但桌面操作系统或 AIR for TV 设备不支持此功能。有关在多个配置文件之间支持 API 的详细信息，请参阅 AIR 配置文件支持。

相关 API 元素

距离上次用户输入的时间，以秒为单位。

相关 API 元素

激活此应用程序。

不支持 NativeWindow 类的平台上不支持此方法。

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

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

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

激活操作是同步的。

参数

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

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

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

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

如果不再需要某个事件侦听器，可调用 removeEventListener() 删除它，否则会产生内存问题。事件侦听器不会自动从内存中删除，因为只要调度对象存在，垃圾回收器就不会删除侦听器（除非 useWeakReference 参数设置为 true）。

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

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

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

参数

function(evt:Event):void

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

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

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

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

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

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

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

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

参数

终止此应用程序。

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

请注意，不会调度 exiting 事件。如果应用程序逻辑需要 exiting 事件，请调用 NativeApplication.nativeApplication.dispatchEvent()，并传入一个类型为 exiting 的 Event 对象。对于任何打开的窗口，NativeWindow 对象调度 closing 和 close 事件。调用 closing 事件对象的 preventDefault() 方法可防止退出应用程序。

注意：iOS 操作系统不支持此方法。

参数

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

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

此方法不适用于 AIR for TV 设备。如果通过在应用程序描述符中声明的文件类型来调用它，将返回 null。

参数

相关 API 元素

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

AIR 配置文件支持：所有桌面操作系统均支持此功能，但移动设备或 AIR for TV 设备不支持此功能。您可以使用 NativeApplication.supportsDefaultApplication 属性在运行时测试是否受支持。有关在多个配置文件之间支持 API 的详细信息，请参阅 AIR 配置文件支持。

参数

相关 API 元素

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

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

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

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

参数

相关 API 元素

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

参数

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

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

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

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

参数

相关 API 元素

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

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

AIR for TV 设备从不自动调度此事件。 但是您可以手动调度。

此事件具有以下属性：

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

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

<allowBrowserInvocation>true</allowBrowserInvocation>

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

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

AIR for TV 设备从不自动调度此事件。 但是您可以手动调度。

此事件具有以下属性：

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

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

AIR for TV 设备从不调度 exiting 事件。

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

此事件具有以下属性：

在调用应用程序时调度。

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

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

InvokeEvent 对象具有以下属性：

用户按下某个键时调度。NativeApplication 实例提供此事件以支持键盘快捷方式。 此键盘事件首先被调度到 NativeApplication。取消此事件的同时还会取消 NativeWindow 菜单快捷方式。该事件在 keyUp 事件之前发生。

此事件具有以下属性：

相关 API 元素

用户释放某个键时调度。NativeApplication 实例提供此事件以支持键盘快捷方式。 此键盘事件首先被调度到 NativeApplication。如果取消此事件，对其他对象没有影响（例如，NativeWindow 菜单快捷方式）。此事件发生在 keyDown 事件之后。

此事件具有以下属性：

相关 API 元素

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

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

注意：

• 网络更改与此事件的传送之间可能有短暂延迟。
• 在 Android 上，NativeApplication 对象可能对网络连接中的每个更改调度多个 networkChange 事件。

此事件具有以下属性：

当操作系统要暂停应用程序时调度。

此事件具有以下属性：

当用户空闲时调度。

使用 idleThreshold 属性指定在调度此事件之前用户处于空闲的时间。用户已经处于空闲状态的时间可以从 timeSinceLastUserInput 属性确定。

注意： 此事件不在移动设备或 AIR for TV 设备上调度。

此事件具有以下属性：

相关 API 元素

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

注意： 此事件不在移动设备或 AIR for TV 设备上调度。

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

此事件具有以下属性：

相关 API 元素