Тип геопрямоугольника QML Basic

Тип georectangle представляет прямоугольную географическую область.

Тип georectangle — это геофигура, представляющая прямоугольную географическую область. Тип является прямым представлением QGeoRectangle. Он определяется парой координат, которые представляют верхне-левый и нижне-правый углы georectangle. Координаты доступны из атрибутов topLeft и bottomRight.

georectangle считается недействительным, если координаты верхне-левого или нижне-правого угла недействительны или если координата верхне-левого угла расположена южнее координаты нижне-правого угла.

Координаты четырёх углов georectangle доступны через атрибуты topLeft, topRight, bottomLeft и bottomRight. Атрибут center можно использовать для получения координат центра georectangle. Атрибуты width и height можно использовать для получения ширины и высоты georectangle в градусах. Установка одного из этих атрибутов приведет к соответствующей корректировке других атрибутов.

Ограничения

georectangle никогда не может пересекать полюса.

Если высота или центр georectangle корректируются таким образом, что он пересекает один из полюсов, высота изменяется таким образом, чтобы georectangle касался, но не пересекал полюс, а координата центра по-прежнему находилась в центре georectangle.

Пример использования

Используйте свойства типа variant для хранения georectangle. Чтобы создать значение georectangle, используйте функцию QtPositioning.rectangle():

import QtPositioning 5.2

Item {
    property variant region: QtPositioning.rectangle(QtPositioning.coordinate(-27.5, 153.1), QtPositioning.coordinate(-27.6, 153.2))
}

При интеграции с C++, обратите внимание, что любое значение QGeoRectangle, переданное в QML из C++, автоматически преобразуется в значение georectangle, и наоборот.

Свойства

bottomLeft

coordinate bottomLeft

Это свойство содержит координату нижнего левого угла этого геопрямоугольника.

bottomRight

coordinate bottomRight

Это свойство содержит координату нижнего правого угла этого геопрямоугольника.

center

coordinate center

Это свойство содержит координату центра этого геопрямоугольника. Для получения более подробной информации см. QGeoRectangle::setCenter().

height

double height

Это свойство содержит высоту этого геопрямоугольника (в градусах). Для получения более подробной информации см. QGeoRectangle::setHeight().

Примечание: Если геопрямоугольник недействителен, установить высоту невозможно. Выпуски QtPositioning до Qt 5.5 разрешали установку высоты даже для недействительных геопрямоугольников.

topLeft

coordinate topLeft

Это свойство содержит координату верхнего левого угла этого геопрямоугольника.

topRight

coordinate topRight

Это свойство содержит координату верхнего правого угла этого геопрямоугольника.

width

double width

Это свойство содержит ширину этого геопрямоугольника (в градусах). Для получения более подробной информации см. QGeoRectangle::setWidth().

Примечание: Если геопрямоугольник недействителен, установить ширину невозможно. Выпуски QtPositioning до Qt 5.5 разрешали установку ширины даже для недействительных геопрямоугольников.