应用对象 QML 类型

应用程序管理器已知的某应用程序的处理程序。更多信息...

导入语句	import QtApplicationManager.SystemUI 2.0

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

属性

别名 : bool
应用程序属性 : object
已阻止 : bool
内置 : bool
能力 : list
类别 : list
代码目录 : string
文档 URL : string
图标 : url
ID : string
最后退出代码 : int
最后退出状态 : enumeration
非别名的 : ApplicationObject
包 : Package
运行状态 : enumeration
运行时 : Runtime
运行时名称 : string
运行时参数 : object
状态 : enumeration
支持的 MIME 类型 : list
版本 : string

信号

激活()

方法

bool debug(string debugWrapper, string document)
string 名称(string language)
bool 启动(string document)
停止(bool forceKill)

详细描述

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

大多数只读属性直接映射到从应用程序包的 info.yaml 文件中读取的值 - 这些已在清单定义中进行了文档化。

此类型的项目不能从 QML 代码中创建。只有 ApplicationManager 和 ApplicationModel 的功能和属性才会返回此类对象的指针。

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

属性文档

[只读] 别名 : bool

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

此参数曾被用于区分应用程序别名，现已由意图机制所取代。

始终返回 false。

[只读] applicationProperties : object

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

[只读] blocked : bool

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

使用 PackageObject::version。

[只读] builtIn : bool

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

使用 PackageObject::builtIn。

[只读] capabilities : list<string>

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

[只读] categories : list<string>

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

使用 PackageObject::categories。

[只读] codeDir : string

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

[只读] documentUrl : string

此参数曾被用于区分应用程序别名，现已由意图机制所取代。

始终返回空字符串。

[只读] icon : url

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

使用 PackageObject::icon。

[只读] id : string

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

[只读] lastExitCode : int

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

[只读] lastExitStatus : 枚举

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

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

另请参阅 ApplicationInterface::quit 和 ApplicationInterface::acknowledgeQuit。

[只读] nonAliased : ApplicationObject

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

此参数曾被用于区分应用程序别名，现已由意图机制所取代。

始终返回自身 ApplicationObject。

[只读] package : Package

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

[只读] runState : 枚举

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

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

[只读] runtime : Runtime

如果应用程序当前正在启动、运行或关闭，则返回一个有效的 Runtime 对象。如果没有开始，可能返回一个 null 对象。

[只读] runtimeName : 字符串

此属性保存运行时的名称，必要用以运行应用程序代码。

[只读] runtimeParameters : 对象

此属性保存一个传递到并解释由应用程序运行时的 QVariantMap。

[只读] state : 枚举

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

使用 PackageObject::state。

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

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

[只读] version : 字符串

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

使用 PackageObject::version。

信号文档

activated()

当应用程序启动或当它已经在运行，但被请求带到前台或提升时，触发此信号。

注意： 相关的处理器是 onActivated。

方法文档

bool debug(字符串 debugWrapper, 字符串 document)

与 start() 相同，不同之处在于它通过给定的 debugWrapper 启动。可选的 document 参数将按原样提供给应用程序 - 最常用的是用于引用要显示的文档。

有关如何设置和使用这些调试包装器，请参阅调试页面.

返回一个表示成功的布尔值。有关更多信息，请参阅完整文档 ApplicationManager::debugApplication。

字符串 name(字符串 language)

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

使用 PackageObject::names 属性。

返回在指定 language 的应用程序名称。

布尔 start(字符串 document)

启动应用程序。可选参数 document 将按原样传递给应用程序 - 通常这用于引用要显示的文档。

返回表示成功的布尔值。有关更多信息，请参阅完整文档 ApplicationManager::startApplication。

stop(布尔 forceKill)

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

另请参阅 ApplicationManager::stopApplication。