应用程序对象 QML 类型

应用程序管理器已知的应用程序句柄。更多...

导入语句	import QtApplicationManager.SystemUI 2.0

所有成员列表，包括继承成员

属性

alias : bool
applicationProperties : object
blocked : bool
builtIn : bool
capabilities : list
categories : list
codeDir : string
description : string
descriptions : var
documentUrl : string
icon : url
id : string
lastExitCode : int
lastExitStatus : enumeration
name : string
names : var
nonAliased : ApplicationObject
package : Package
runState : enumeration
runtime : Runtime
runtimeName : string
runtimeParameters : object
state : enumeration
supportedMimeTypes : list
version : string

信号

activated()

方法

bool debug(string debugWrapper, string document)
bool start(string document)
stop(bool forceKill)

详细描述

此类的一个实例表示应用管理器已知的一个单独的应用程序。

大多数只读属性直接映射到从应用包的info.yaml文件中读取的值 - 这些在清单定义中有说明。

此类型的项目无法从QML代码创建。只有ApplicationManager和ApplicationModel的函数和属性才会返回指向此类的指针。

确保不要在函数调用之间保存对ApplicationObject的引用：指南（及其包含的应用程序）可以在任何时刻被卸载，从而使您的引用无效。如果您确实需要持久引用，请使用ID字符串。

属性文档

alias : bool [只读]

此方法已过时。它提供是为了保持旧源代码的功能性。我们强烈建议不要在新代码中使用它。

这曾经用于区分应用程序别名，这些别名已被'intents'机制所取代。

始终返回false。

applicationProperties : object [只读]

列出在清单文件中applicationProperties字段的私有和受保护部分中列出的所有用户定义的应用程序属性。

blocked : bool [只读]

此方法已过时。它提供是为了保持旧源代码的功能性。我们强烈建议不要在新代码中使用它。

使用PackageObject::version。

builtIn : bool [只读]

此方法已过时。它提供是为了保持旧源代码的功能性。我们强烈建议不要在新代码中使用它。

使用PackageObject::builtIn。

capabilities : list<string> [只读]

这是一个应用程序的特殊访问权限列表 - 这些能力可以通过应用程序管理器由中间件查询和验证。

categories : list<string> [只读]

这是一个与应用程序相关联的类别名称列表。这主要是为了在系统UI中显示应用。如果应用程序没有指定categories列表，这将与包含的PackageObject::categories相同返回。

codeDir : string [只读]

指向应用程序安装目录的绝对路径。

description : string [只读]

返回应用程序的局部化描述 - 如在info.yaml文件中所提供的 - 以当前活动区域设置的形式。

此属性使用与name属性相同的算法，但是用于描述。

descriptions : var [只读]

返回一个对象，包含所有语言代码到本地化描述映射，如应用info.yaml文件中提供。如果应用程序没有指定descriptions对象，此将返回包含的PackageObject::descriptions相同。

documentUrl : 字符串 [只读]

这曾经用于区分应用程序别名，这些别名已被'intents'机制所取代。

总是返回一个空字符串。

icon : URL [只读]

应用程序图标的URL - 可以作为 Image 的源属性使用。如果应用程序没有指定 icon，这将返回与包含的 PackageObject::icon 相同的结果。

id : 字符串 [只读]

此属性返回应用程序的唯一ID。

lastExitCode : 整数 [只读]

此属性在多进程模式下保存应用程序进程的最后退出码。在成功关闭应用程序时，此值通常应等于 0，但可以是应用程序从其 main() 函数返回的任何值。

lastExitStatus : 枚举 [只读]

此属性返回多进程模式下应用程序进程的最后退出状态。

Am.NormalExit - 应用程序正常退出。
Am.CrashExit - 应用程序崩溃。
Am.ForcedExit - 应用程序由于应用程序管理器杀死，因为它忽略了从对 ApplicationManager::stopApplication 的调用产生的退出请求。

另请参阅ApplicationInterface::quit 和 qua Белkt.Join。

name : 字符串 [只读]

返回应用程序的本地化名称 - 如在 info.yaml 文件中提供 - 在当前活动区域设置中。

这是一个方便的属性，它接受 names 属性返回的映射，然后尝试返回这些键的值（如果有的话）：首先是当前区域设置的ID，然后是 en_US，然后是 en，最后是第一个可用的键。

如果没有可用映射，这将返回 id。

names : 变量 [只读]

返回一个对象，其中包含在应用程序的 info.yaml 文件中提供的所有语言代码到本地化名称的映射。如果应用程序没有指定 names 对象，这将返回与包含的 PackageObject::names 相同的结果。

nonAliased : ApplicationObject [只读]

此方法已过时。它提供是为了保持旧源代码的功能性。我们强烈建议不要在新代码中使用它。

这曾经用于区分应用程序别名，这些别名已被'intents'机制所取代。

总是返回 ApplicationObject 本身。

package : Package [只读]

返回包含此应用程序的包对象。

runState : 枚举 [只读]

此属性保存应用程序的当前运行状态。它可以有以下一种

Am.NotRunning - 应用程序尚未启动。
Am.StartingUp - 应用程序已启动并正在初始化。
Am.Running - 应用程序正在运行。
关机中 - 应用程序已停止并正在清理（在多进程模式下，只有在应用程序以优雅的方式终止时才会达到此状态）。

runtime : 运行时 [只读]

如果应用程序当前正在启动、运行或关闭，将返回一个有效的运行时对象。如果应用程序尚未启动，可能返回一个 null 对象。

runtimeName : 字符串 [只读]

此属性包含运行时的名称，这是运行应用程序代码所必需的。

runtimeParameters : 对象 [只读]

此属性包含传递给并由应用程序的运行时处理的 QVariantMap。

state : 枚举 [只读]

此方法已过时。它提供是为了保持旧源代码的功能性。我们强烈建议不要在新代码中使用它。

请使用 PackageObject::state。

supportedMimeTypes : 列表<字符串> [只读]

一个应用程序可以处理的 MIME 类型的数组。

version : 字符串 [只读]

此方法已过时。它提供是为了保持旧源代码的功能性。我们强烈建议不要在新代码中使用它。

使用PackageObject::version。

信号文档

activated()

当应用程序启动，或者在它已经运行但被请求将其带到前台或提高优先级时，将发出此信号。

注意：相应的处理程序是 onActivated。

方法文档

bool debug(string debugWrapper, string document)

与 start() 相同，只是它通过给定的 debugWrapper 启动。可选参数 document 将与应用程序原样提供 - 最常见的做法是 used to refer to a document to display。

有关如何设置和使用这些调试包装器的更多信息，请参阅调试页面。

返回一个指示成功的 bool 值。有关更多信息，请参见 ApplicationManager::debugApplication 的完整文档。

bool start(string document)

启动应用程序。可选参数 document 将与应用程序原样提供 - 最常见的做法是 used to refer to a document to display。

返回一个指示成功的 bool 值。有关更多信息，请参见 ApplicationManager::startApplication 的完整文档。

stop(bool forceKill)

停止应用程序。forceKill 参数的含义取决于运行时，但通常您应该首先尝试将 forceKill 设置为 false 来停止应用程序，以便允许干净的关闭。只有作为最后的手段，将 forceKill 设置为 true 来杀死挂起的程序。

支持ApplicationInterface的支持QML应用程序和本地应用程序将通过ApplicationInterface通知ApplicationInterface::quit（）。所有其他应用程序将收到Unix的TERM信号。

另请参阅 ApplicationManager::stopApplication。