ApplicationRequestHandler QML 类型

用于执行操作的客户端。 更多...

Qt 5.11
继承

QtObject

属性

方法

详细描述

ApplicationRequestHandler 不旨在直接在系统中使用,而是作为接收来自使用 Qt.openUrlExternally 函数的应用程序的请求数据,如下例所示。

用法示例

Button {
    id: openTunerApp
    onClicked: {
        Qt.openUrlExternally("x-tuner://");
    }
}

Button {
    id: openPhoneAppBluetoothMenu
    onClicked: {
        Qt.openUrlExternally("x-phone://settings/bluetooth");
    }
}

处理应用程序请求的接口。一个请求用来指示应用程序打开或以特定状态打开。换句话说,该操作应该可以在系统的任何地方执行。应用程序可以调用 Qt.openUrlExternally() 函数,并将要打开的应用程序的mime-type作为参数传递,后面跟一个表示应用程序打开时应执行什么操作的url。为了实现这一点,相应的 mime-Types 应相应地添加到应用程序的 info.yaml 文件中(例如:mimeTypes: [ 'x-scheme-handler/x-tuner' ])。之后,ApplicationManager 将咨询其应用程序的内部数据库,寻找与 x-scheme-handler/x-mimeType 匹配的应用程序。如果成功匹配,则将发出 openUrlRequested 信号,其接收者(ApplicationRequestHandler)可以确认请求通过调用 acknowledgeOpenUrlRequest 函数,或者拒绝(rejectOpenUrlRequest)。如果应用程序随后启动,则通过 signal openDocument(string documentUrl, string mimeType) 通过其 ApplicationInterface 将 url 供给应用程序作为文档。

属性文档

ApplicationRequestHandler : string

此属性保存活动应用程序 id。它在提交应用程序请求之前存储活动应用程序 id,以便能够相应地导航到它。


activeAppId : string

此属性保存活动应用程序 id。它在提交应用程序请求之前存储活动应用程序 id,以便能够相应地导航到它。


[只读] appManConns : var

此属性用于监听 ApplicationManager 并获取来自其他应用程序的请求。


history : var

该属性保存了启动的活动历史记录,并用于依次导航回初始状态。


方法文档

goBack()

goBack函数根据历史记录从一个请求的操作返回到前一个状态。同时也会相应地更新历史记录。


sendRequest(id, params)

请求在UI中执行的动作。它使用应用程序管理员的acknowledgeOpenUrlRequest函数来打开请求的应用程序,并将给定的url传递给它。每次调用该函数时,它还保留并更新所有执行步骤的历史记录。


©2019 Luxoft Sweden AB。本文档中的文档贡献包括其各自所有者的版权。
所提供的文档根据Free Software Foundation发布的GNU自由文档许可协议版本1.3的条款进行许可。
Qt及其相关标志是芬兰及/或全球其他国家的Qt公司有限公司的商标。所有其他商标均为其各自所有者的财产。