Интерфейсы между кодом 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));