georectangle QML Базовый тип

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