Тип georectangle QML

Тип 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

Это свойство содержит координату нижнего левого угла данного georectangle.

bottomRight

coordinate bottomRight

Это свойство содержит координату нижнего правого угла данного georectangle.

center

coordinate center

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

height

double height

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

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

topLeft

coordinate topLeft

Это свойство содержит координату верхнего левого угла данного georectangle.

topRight

coordinate topRight

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

width

double width

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

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