геопрямоугольник QML Базовый тип

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

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

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

Ограничения

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

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

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

Для хранения georectangle используются свойства типа variant. Для создания значения 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 допускали установку ширины даже для недействительных геопрямоугольников.