Einbettung von C++-Objekten in QML mithilfe von Kontexteigenschaften

Beim Laden eines QML-Objekts in eine C++-Anwendung kann es nützlich sein, einige C++-Daten direkt einzubetten, die dann aus dem QML-Code heraus verwendet werden können. Dies ermöglicht es beispielsweise, eine C++-Methode auf dem eingebetteten Objekt aufzurufen oder eine C++-Objektinstanz als Datenmodell für eine QML-Ansicht zu verwenden.

Die Einbindung von C++-Daten in ein QML-Objekt wird durch die Klasse „ QQmlContext “ ermöglicht. Diese Klasse stellt Daten im Kontext eines QML-Objekts bereit, sodass direkt aus dem Geltungsbereich des QML-Codes auf die Daten verwiesen werden kann.

Festlegen einer einfachen Kontexteigenschaft

Hier ist beispielsweise ein QML-Element, das auf einen ` currentDateTime `-Wert verweist, der im aktuellen Geltungsbereich nicht existiert:

// MyItem.qml
import QtQuick

Text { text: currentDateTime }

Dieser ` currentDateTime `-Wert kann direkt von der C++-Anwendung, die die QML-Komponente lädt, mithilfe von ` QQmlContext::setContextProperty()` gesetzt werden:

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

Ein Objekt als Kontexteigenschaft festlegen

Kontexteigenschaften können entweder Werte vom Typ ` QVariant ` oder ` QObject*` enthalten. Das bedeutet, dass auch benutzerdefinierte C++-Objekte auf diese Weise eingebunden werden können und diese Objekte direkt in QML geändert und ausgelesen werden können. Hier passen wir das obige Beispiel so an, dass anstelle eines ` QDateTime `-Werts eine ` QObject `-Instanz eingebettet wird, und der QML-Code ruft eine Methode der Objektinstanz auf:

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

(Beachten Sie, dass von C++ an QML zurückgegebene Datums-/Zeitwerte über ` Qt.formatDateTime()` und zugehörige Funktionen formatiert werden können.)

Wenn das QML-Element Signale von der Context-Eigenschaft empfangen soll, kann es diese mithilfe des Typs ` Connections ` verbinden. Wenn beispielsweise ` ApplicationData ` ein Signal namens ` dataChanged()` hat, kann dieses Signal mithilfe eines ` onDataChanged `-Handlers innerhalb eines ` Connections `-Objekts verbunden werden:

Text {
    text: applicationData.getCurrentDateTime()

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

Weitere Informationen finden Sie auch in der Dokumentation zu „ QQmlContext “.