Interfaces entre C++ et QML Code en Qt Positioning
Vue d'ensemble
Qt Positioning utilise deux méthodes pour simplifier l'échange de données de position entre le code C++ et le code QML.
Intégration directe des valeurs C++ dans QtPositioning
À partir de Qt 5.5, il est devenu beaucoup plus facile d'intégrer des types de données non basés surQObject dans QML. Pour ce faire, la prise en charge de Q_GADGET a été ajoutée à QtQml. La macro convertit les classes en une version allégée de QObject sans l'héritage QObject requis. En même temps, elle conserve les capacités de réflexion de QMetaObject. Par conséquent, ils peuvent être directement exposés à QML.
Un nombre important de types de données liés à la position ont été convertis en Q_GADGET. Ils conservent leur API et leur caractère de type de valeur, mais sont devenus introspectables via QMetaObject.
La macro QML_ANONYMOUS est utilisée pour exposer ces types à l'environnement QML. Voir la documentation QQmlEngine pour plus de détails et la liste complète des macros disponibles.
Les classes ne sont cependant pas directement étendues avec cette macro, car nous ne voulons pas que Qt Positioning dépende de QtQml. Une classe d'aide est donc créée pour chacune d'entre elles, et la macro QML_FOREIGN est utilisée :
struct QGeoCoordinateForeign { Q_GADGET QML_FOREIGN(QGeoCoordinate) QML_ANONYMOUS QML_ADDED_IN_VERSION(5, 0) };
L'enregistrement ci-dessus des types de positionnement est automatiquement effectué une fois par le plugin QML QtPositioning.
Intégration basée sur les variables Q
Cette section fournit des informations sur la manière d'intégrer QGeoAddress et QGeoLocation.
Adresse - QGeoAddress
La propriété Address.address est utilisée pour fournir une interface entre le code C++ et le code QML. Tout d'abord, un pointeur sur un objet Address doit être obtenu à partir de C++, puis les fonctions property() et setProperty() doivent être utilisées pour obtenir et définir la propriété address.
Le morceau de code suivant obtient l'objet QGeoAddress à partir de C++ :
QGeoAddress geoAddress = qmlObject->property("address").value<QGeoAddress>();
Le morceau de code suivant définit la propriété d'adresse de l'objet QML sur la base d'un objet QGeoAddress provenant de C++ :
qmlObject->setProperty("address", QVariant::fromValue(geoAddress));
Emplacement - QGeoLocation
La propriété Location.location est utilisée pour fournir une interface entre le code C++ et le code QML. Il faut d'abord obtenir un pointeur sur un objet Location à partir de C++, puis utiliser les fonctions property() et setProperty() pour obtenir et définir la propriété location.
Le morceau de code suivant obtient l'objet QGeoLocation à partir de C++ :
QGeoLocation geoLocation = qmlObject->property("location").value<QGeoLocation>();
Le morceau de code suivant définit la propriété location de l'objet QML sur la base d'un objet QGeoLocation provenant de C++ :
qmlObject->setProperty("location", QVariant::fromValue(geoLocation));
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.