컨텍스트 속성을 사용하여 C++ 객체를 QML에 삽입하기

QML 객체를 C++ 애플리케이션에 로드할 때, QML 코드 내에서 사용할 수 있는 일부 C++ 데이터를 직접 내장하는 것이 유용할 수 있습니다. 이를 통해 예를 들어, 내장된 객체에 대한 C++ 메서드를 호출하거나, C++ 객체 인스턴스를 QML 뷰의 데이터 모델로 사용할 수 있습니다.

QML 객체에 C++ 데이터를 주입하는 기능은 ` QQmlContext ` 클래스를 통해 구현됩니다. 이 클래스는 QML 객체의 컨텍스트에 데이터를 노출하여, QML 코드의 범위 내에서 해당 데이터를 직접 참조할 수 있도록 합니다.

간단한 컨텍스트 속성 설정

예를 들어, 다음은 현재 범위 내에 존재하지 않는 ` currentDateTime ` 값을 참조하는 QML 항목입니다.

// MyItem.qml
import QtQuick

Text { text: currentDateTime }

이 ` currentDateTime ` 값은 QML 컴포넌트를 로드하는 C++ 애플리케이션에서 ` QQmlContext::setContextProperty()`를 사용하여 직접 설정할 수 있습니다:

QQuickView view;
view.rootContext()->setContextProperty("currentDateTime", QDateTime::currentDateTime());
view.setSource(QUrl::fromLocalFile("MyItem.qml"));
view.show();

객체를 컨텍스트 속성으로 설정하기

컨텍스트 속성은 ` QVariant ` 또는 ` QObject*` 값을 가질 수 있습니다. 즉, 이 방식을 사용하여 사용자 정의 C++ 객체를 주입할 수 있으며, 이러한 객체는 QML에서 직접 수정하고 읽을 수 있습니다. 여기서는 위 예제를 수정하여 ` QDateTime ` 값 대신 ` QObject ` 인스턴스를 삽입하고, QML 코드에서 해당 객체 인스턴스의 메서드를 호출하도록 합니다:

class ApplicationData : public QObject
{
    Q_OBJECT
public:
    Q_INVOKABLE QDateTime getCurrentDateTime() const {
        return QDateTime::currentDateTime();
    }
};

int main(int argc, char *argv[]) {
    QGuiApplication app(argc, argv);

    QQuickView view;

    ApplicationData data;
    view.rootContext()->setContextProperty("applicationData", &data);

    view.setSource(QUrl::fromLocalFile("MyItem.qml"));
    view.show();

    return app.exec();
}

// MyItem.qml
import QtQuick

Text { text: applicationData.getCurrentDateTime() }

(C++에서 QML로 반환된 날짜/시간 값은 ` Qt.formatDateTime()` 및 관련 함수를 통해 서식을 지정할 수 있습니다.)

QML 항목이 컨텍스트 속성으로부터 신호를 수신해야 하는 경우, ` Connections ` 유형을 사용하여 해당 신호에 연결할 수 있습니다. 예를 들어, ` ApplicationData `에 ` dataChanged()`라는 신호가 있는 경우, ` Connections ` 객체 내의 ` onDataChanged ` 핸들러를 사용하여 이 신호에 연결할 수 있습니다:

Text {
    text: applicationData.getCurrentDateTime()

    Connections {
        target: applicationData
        onDataChanged: console.log("The application data changed!")
    }
}

자세한 내용은 QQmlContext 문서를 참조하십시오.