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