IntentClient QML 类型

单例，提供创建意图请求的功能。更多...

导入语句	import QtApplicationManager 2.0

包括继承成员在内的所有成员列表

属性

systemUiId : string

方法

bool broadcastIntentRequest(string intentId, var parameters) (自 6.5)
IntentRequest sendIntentRequest(string intentId, var parameters)
IntentRequest sendIntentRequest(string intentId, string applicationId, var parameters)

详细说明

此类型既可用于应用程序中，也可用于系统 UI 中创建意图请求。此类型仅是工厂，返回类型 IntentRequest 的实例。有关如何处理这些异步调用的详细信息，请参阅 IntentRequest 文档。

以下是发送意图请求并对其结果（或错误消息）做出响应的相当标准的方式：

MouseArea {
    onClicked: {
        var request = IntentClient.sendIntentRequest("show-image", { url: "file://x.png" })
        request.onReplyReceived.connect(function() {
            if (request.succeeded)
                var result = request.result
            else
                console.log("Intent request failed: " + request.errorMessage)
        })
    }
}

属性文档

systemUiId : string

用于针对意图请求系统 UI 的硬编码、特殊应用 ID。

方法文档

[since 6.5] bool broadcastIntentRequest(string intentId, var parameters)

向系统广播具有给定 intentId 的意图请求。附加的 parameters 是特定于请求的 intentId，但格式始终相同：一个标准 JavaScript 对象，也可以是空的，如果请求的意图不需要任何参数。

广播请求不会生成回复。返回值始终为 false，如果用无效参数调用此函数。

此方法是在 Qt 6.5 中引入的。

IntentRequest sendIntentRequest(string intentId, var parameters)

向系统发送具有给定 intentId 的意图请求。附加的 parameters 是特定于请求的 intentId，但格式始终相同：一个标准 JavaScript 对象，也可以是空的，如果请求的意图不需要任何参数。

返回一个IntentRequest对象，可用于跟踪此异步请求。

注意：返回的对象具有JavaScript所有权，这意味着您无需担心释放资源。即使忽略返回值也没关系，如果您对请求（或错误条件）的结果不感兴趣。

IntentRequest sendIntentRequest(string intentId, string applicationId, var parameters)

这是一个重载函数。

您可以使用此重载替代让系统UI（或用户）选择哪个应用程序应该处理您的请求，您可以使用此重载硬编码必要的applicationId以处理它。如果指定的应用程序不存在或无法处理此特定请求，则请求将失败，尽管其他应用程序可以做到。

存在特殊的应用程序ID IntentClient.systemUiId，可用于定位系统UI。

另请参阅：sendIntentRequest。