WorkerScript QML Type

Qt Quick 애플리케이션에서 스레드 사용을 활성화합니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• ready : bool
• source : url

신호

• message(jsobject msg)

방법

• sendMessage(jsobject message)

자세한 설명

작업자 스크립트를 사용하여 새 스레드에서 작업을 실행합니다. 이는 메인 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() 핸들러가 응답 메시지를 수신합니다.

이 예에서는 확장자가 ".mjs"인 ECMAScript 모듈인 스크립트를 사용합니다. 이 스크립트는 가져오기 문을 사용하여 다른 모듈의 기능에 액세스할 수 있으며 JavaScript 엄격 모드에서 실행됩니다.

작업자 스크립트의 확장자가 ".js"인 경우 일반 JavaScript 문이 포함된 것으로 간주되며 비강제 모드에서 실행됩니다.

제한 사항

WorkerScript.onMessage() 함수는 별도의 스레드에서 실행되므로 JavaScript 파일은 기본 QML 엔진과는 별도의 컨텍스트에서 평가됩니다. 즉, QML로 가져오는 일반 JavaScript 파일과 달리 위 예제의 script.mjs 은 QML 항목의 속성, 메서드 또는 기타 속성에 액세스할 수 없으며 QQmlContext 을 통해 QML 객체에 설정된 컨텍스트 속성에도 액세스할 수 없습니다.

또한 워커 스크립트와 주고받을 수 있는 값의 유형에도 제한이 있습니다. 자세한 내용은 sendMessage() 문서를 참조하세요.

일반 JavaScript 소스인 워커 스크립트는 .import 구문을 사용할 수 없습니다. ECMAScript 모듈인 스크립트는 가져오기 및 내보내기 문을 자유롭게 사용할 수 있습니다.

속성 문서

신호 문서

메서드 문서