WorkerScript QML Type

Ermöglicht die Verwendung von Threads in einer Qt Quick Anwendung. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• ready : bool
• source : url

Signale

• message(jsobject msg)

Methoden

• sendMessage(jsobject message)

Ausführliche Beschreibung

Verwenden Sie WorkerScript, um Operationen in einem neuen Thread auszuführen. Dies ist nützlich, um Operationen im Hintergrund auszuführen, damit der Haupt-GUI-Thread nicht blockiert wird.

Nachrichten können zwischen dem neuen Thread und dem Eltern-Thread mit sendMessage() und dem onMessage() Handler weitergegeben werden.

Ein Beispiel:

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 })
    }
}

Das obige Worker-Skript gibt eine JavaScript-Datei, "script.mjs", an, die die im neuen Thread auszuführenden Operationen verarbeitet. Hier ist script.mjs:

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

Wenn der Benutzer auf eine beliebige Stelle innerhalb des Rechtecks klickt, wird sendMessage() aufgerufen, wodurch der Handler WorkerScript.onMessage() in script.mjs ausgelöst wird. Dieser wiederum sendet eine Antwortnachricht, die dann vom onMessage() -Handler von myWorker empfangen wird.

Das Beispiel verwendet ein Skript, das ein ECMAScript-Modul ist, da es die Erweiterung ".mjs" hat. Es kann Import-Anweisungen verwenden, um auf Funktionen anderer Module zuzugreifen, und es wird im JavaScript-Strict-Modus ausgeführt.

Wenn ein Worker-Skript stattdessen die Erweiterung ".js" hat, wird davon ausgegangen, dass es einfache JavaScript-Anweisungen enthält, und es wird im nicht-strikten Modus ausgeführt.

Beschränkungen

Da die Funktion WorkerScript.onMessage() in einem separaten Thread ausgeführt wird, wird die JavaScript-Datei in einem von der Haupt-QML-Engine getrennten Kontext ausgewertet. Das bedeutet, dass im Gegensatz zu einer gewöhnlichen JavaScript-Datei, die in QML importiert wird, script.mjs im obigen Beispiel nicht auf die Eigenschaften, Methoden oder andere Attribute des QML-Elements zugreifen kann und auch nicht auf Kontexteigenschaften, die für das QML-Objekt über QQmlContext festgelegt wurden.

Darüber hinaus gibt es Beschränkungen für die Arten von Werten, die an das Worker-Skript übergeben und von diesem zurückgegeben werden können. Einzelheiten finden Sie in der Dokumentation sendMessage().

Worker-Skripte, die reine JavaScript-Quellen sind, können keine .import-Syntax verwenden. Skripte, die ECMAScript-Module sind, können Import- und Export-Anweisungen frei verwenden.

Eigenschaft Dokumentation

Signal Dokumentation

Methode Dokumentation