WorkerScript QML 类型

允许在 Qt Quick 应用中使用线程。 更多信息...

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

属性

• ready : bool
• source : url

信号

• message(jsobject msg)

方法

• sendMessage(jsobject message)

详细描述

使用 WorkerScript 在新线程中运行操作。这在后台运行操作以防止主 GUI 线程阻塞时非常有用。

可以使用 sendMessage() 和 onMessage() 处理器在新线程和父线程之间传递消息。

示例

import QtQuick

Rectangle {
    width: 300; height: 300

    Text {
        id: myText
        text: 'Click anywhere'
    }

    WorkerScript {
        id: myWorker
        source: "script.mjs"

        onMessage: (messageObject)=> myText.text = messageObject.reply
    }

    MouseArea {
        anchors.fill: parent
        onClicked: (mouse)=> myWorker.sendMessage({ 'x': mouse.x, 'y': mouse.y })
    }
}

上面的工作脚本指定了一个位于新线程中要执行操作的 JavaScript 文件，"script.mjs"。以下是 script.mjs

WorkerScript.onMessage = function(message) {
    // ... long-running operations and calculations are done here
    WorkerScript.sendMessage({ 'reply': 'Mouse is at ' + message.x + ',' + message.y })
}

当用户在矩形内点击任何地方时，将调用 sendMessage()，触发 script.mjs 中的 WorkerScript.onMessage() 处理器。这接着发送一个回复消息，然后由 myWorker 的 onMessage() 处理器接收。

这个示例使用了一个 ECMAScript 模块作为脚本，因为它具有 ".mjs" 扩展名。它可以使用导入语句来访问来自其他模块的功能，并且它在 JavaScript 严格模式下运行。

如果工作脚本具有 ".js" 扩展名，则认为它包含纯 JavaScript 语句，并且在非严格模式下运行。

限制

由于 WorkerScript.onMessage() 函数在单独的线程中运行，JavaScript 文件是在与主 QML 引擎不同的上下文中评估的。这意味着，与导入到 QML 中的普通 JavaScript 文件不同，上述示例中的 script.mjs 无法访问 QML 物品的属性、方法或其他属性，也不能通过 QQmlContext 访问在 QML 对象上设置的任何上下文属性。

此外，对可以传递到工作脚本和从工作脚本返回的值的类型有一些限制。有关详细信息，请参阅 sendMessage() 的文档。

纯JavaScript源码的Worker脚本不能使用 .import 语法。ECMAScript模块的脚本可以自由使用导入和导出语句。

属性文档

信号文档

方法文档