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