IntentObject QML 类型

此类型表示系统 UI 端的 Intent 定义。 [更多信息...]

导入语句	import QtApplicationManager.SystemUI 2.0

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

属性

applicationId : string
categories : list<string>
description : string
descriptions : var
handleOnlyWhenRunning : bool (since 6.5)
icon : url
intentId : string
name : string
names : var
packageId : string
parameterMatch : var
requiredCapabilities : list<string>
visibility : IntentObject.Visibility

详细描述

此类的一个实例表示特定应用程序的单个 Intent 定义。

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

此类类型不能从 QML 代码中创建。只有 IntentServer 和 IntentModel 的函数和属性会返回对此类的指针。

确保在函数调用之间不要保存对 IntentObject 的引用：包（以及其中包含的意图）可以随时卸载，使您的引用无效。如果确实需要一个持久的句柄，请使用 intentId 与 applicationId 字符串一起使用。

属性文档

applicationId : string [只读]

负责处理此意图的应用程序的 id。

categories : list<string> [只读]

应与意图关联的类别名称列表。这主要用于在系统用户界面中显示意图所属的固定类别。如果意图没有指定 categories 列表，此方法将返回与包含的 PackageObject::categories 相同的结果。

description : string [只读]

返回当前活动区域设置的意图的本地化描述（如 info.yaml 文件中提供）。

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

descriptions : var [只读]

返回一个对象，其中包含在意图的 info.yaml 文件中提供的所有语言代码本地化描述映射。如果意图没有指定 descriptions 对象，此方法将返回与包含的 PackageObject::descriptions 相同的结果。

handleOnlyWhenRunning : bool [只读，自 6.5 版本起]

默认情况下，当请求针对应用程序且该应用程序当前未运行时，应用程序会被自动启动，但如果将此属性设置为 true，则只会将针对此意图的请求转发到实际运行的应用程序处理。这对于仅在应用程序处于活动状态时才相关的系统广播非常有用（例如，互联网可用性的更改）。

此属性在 Qt 6.5 版本中引入。

icon : url [只读]

意图图标的 URL - 可以用作 Image 的源属性。如果意图没有指定 icon，此方法将返回与包含的 PackageObject::icon 相同的结果。

intentId : string [只读]

意图的 ID。

name : string [只读]

返回当前活动区域设置的意图的本地化名称（如 info.yaml 文件中提供）。

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

如果没有可用映射，则返回 intentId。

names : var [只读]

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

packageId : string [只读]

本意图处理应用程序所包含的包的ID。

parameterMatch : var [只读]

处理应用程序可以限制它接受的参数值。该属性本身是一个对象，对应于本意图允许的参数对象的一个子集。当设置时，每个传入意图请求的参数都会与该对象进行匹配，遵循以下规则

parameterMatch 中缺失的字段将被忽略。
parameterMatch 中指定的类型为 string 的字段将作为正则表达式与相应的参数值进行匹配。
parameterMatch 中指定的类型为 list 的字段，相应的参数值必须与该列表中的任何值匹配（使用 QVariant 比较）。
parameterMatch 中的其他字段将与相应的参数值作为 QVariants 进行比较。

一个例子是一个由许多应用程序实现的 open-mime-type 意图：将有一个 mimeType 参数，每个应用程序都可以通过在本 mimeType 参数上设置 parameterMatch 来限制它想要接收的请求，例如 { mimeType: "^image/.*\.png$" }

requiredCapabilities : list<string> [只读]

请求此意图的应用程序需要具有所有给定的功能。

另请参阅 ApplicationObject::capabilities.

visibility : IntentObject.Visibility [只读]

此意图对其他包的可见性。

IntentObject.Public - 任何应用程序都可以请求此意图。
IntentObject.Private - 只有来自同一包的应用程序才能请求此意图。