Интерфейсы между кодом C++ и QML в Qt Positioning

Обзор

В зависимости от типа класса C++, QtPositioning использует два метода для упрощения обмена данными о местоположении между кодом C++ и QML.

Прямая интеграция значений C++ в QtPositioning

Начиная с Qt 5.5, стало гораздо проще интегрировать типы данных, не основанные на QObject, в QML. Это достигается путем добавления поддержки Q_GADGET в QtQml. Макрос преобразует классы в облегченную версию QObject без необходимого наследования от QObject. Одновременно сохраняются возможности рефлексии QMetaObject. В результате они могут быть напрямую экспонированы в QML и не требуют дополнительных оберток.

Значительное количество типов данных, связанных с позицией и местоположением, было преобразовано в Q_GADGET. Они сохраняют свой API и характер типа значения, но стали интроспективными через QMetaObject. Это преобразование было выполнено для следующих классов:

• QGeoCircle
• QGeoCoordinate
• QGeoRectangle
• QGeoShape

Используя QGeoCoordinate в качестве примера, типы C++ напрямую экспонируются в среду QML через свой метатип:

qRegisterMetaType<QGeoCoordinate>();
QMetaType::registerEqualsComparator<QGeoCoordinate>();

Вышеуказанная регистрация QGeoCoordinate автоматически выполняется плагином QML QtPositioning один раз. Пример «Plane Spotter» демонстрирует эту функцию.

Интеграция на основе QVariant

В этом разделе приводится информация о том, как интегрировать QGeoAddress и QGeoLocation.

Адрес - QGeoAddress

Свойство Address.address используется для предоставления интерфейса между кодом C++ и QML. Сначала необходимо получить указатель на объект Address из C++, затем использовать функции property() и setProperty() для получения и установки address свойства. Следующее получает QGeoAddress, представляющий этот объект из C++:

 QGeoAddress geoAddress = qmlObject->property("address").value<QGeoAddress>();

Следующее устанавливает свойства этого объекта на основе объекта QGeoAddress из C++:

qmlObject->setProperty("address", QVariant::fromValue(geoAddress));

Местоположение - QGeoLocation

Свойство Location.location используется для предоставления интерфейса между кодом C++ и QML. Сначала необходимо получить указатель на объект Location из C++, затем использовать функции property() и setProperty() для получения и установки location свойства. Следующее получает QGeoLocation, представляющий этот объект из C++:

QGeoLocation geoLocation = qmlObject->property("location").value<QGeoLocation>();

Следующее устанавливает свойства этого объекта на основе объекта QGeoLocation из C++:

qmlObject->setProperty("location", QVariant::fromValue(geoLocation));