컨텍스트 속성을 사용하여 QML에 C++ 객체 임베드하기

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

컨텍스트 속성은 QML 보기에서 C++ 기반 데이터 모델을 사용하는 데 유용할 수 있습니다. 다음 예제를 참조하세요:

• 문자열 ListModel
• 객체 ListModel
• AbstractItemModel

QStringList, QList<QObject*> 기반 모델 및 QAbstractItemModel 을 QML 보기에서 사용하는 방법을 보여줍니다.

자세한 내용은 QQmlContext 문서를 참조하세요.