WorkerScript QML Type

在Qt Quick 应用程序中启用线程。更多

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

属性

• ready : bool
• source : url

信号

• message(jsobject msg)

方法

• sendMessage(jsobject message)

详细说明

使用 WorkerScript 在新线程中运行操作。这有助于在后台运行操作，从而避免阻塞图形用户界面主线程。

可以使用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 })
    }
}

上述 Worker 脚本指定了一个 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 严格模式下运行。

如果 Worker 脚本的扩展名为".js"，那么它将被视为包含纯 JavaScript 语句，并以非严格模式运行。

限制条件

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

此外，可传入和传出 Worker 脚本的值类型也有限制。详情请查看sendMessage() 文档。

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

属性文档

信号文档

方法文档