地理矩形 QML 值类型

地理矩形类型表示一个矩形地理区域。更多...

导入语句	import QtPositioning

详细描述

类型 georectangle 是一个表示矩形地理区域的 geoshape。该类型是 QGeoRectangle 的直接表示。它由一对表示 georectangle 上下左右角落的 coordinates 组成。这些坐标可以通过 topLeft 和 bottomRight 属性访问。

如果上下左右坐标无效，或如果上下坐标位于底部右边坐标的南方，则认为 georectangle 无效。

可以使用 topLeft、topRight、bottomLeft 和 bottomRight 属性访问 georectangle 四个角落的坐标。可以使用 center 属性获取 georectangle 的中心坐标。可以使用 width 和 height 属性获取以度为单位 georectangle 的宽度和高度。设置这些属性之一将导致其他属性相应调整。

限制

地理矩形永远不能穿过极点。

如果调整了一个地理矩形的长度或中心位置使其穿过极点，长度将修改为与极点接触但不穿过极点，并且中心坐标仍在矩形中央。

示例用法

使用类型 var 的属性来存储地理矩形。要创建地理矩形值，请使用QtPositioning.rectangle() 函数

import QtPositioning

Item {
    property var region: QtPositioning.rectangle(QtPositioning.coordinate(-27.5, 153.1), QtPositioning.coordinate(-27.6, 153.2))
}

当与 C++ 集成时，请注意，任何从 C++ 传递到 QML 的 QGeoRectangle 值都会自动转换为 georectangle 值，反之亦然。

属性

bottomLeft

coordinate bottomLeft

此属性持有地理矩形的左下角坐标。

bottomRight

coordinate bottomRight

此属性持有地理矩形的右下角坐标。

center

coordinate center

此属性存储了这个地理矩形的中心坐标。更多信息请参阅QGeoRectangle::setCenter。

高度

double height

此属性存储了这个地理矩形的高度（以度为单位）。更多信息请参阅QGeoRectangle::setHeight。

注意： 如果地理矩形无效，则无法设置高度。QtPositioning在Qt 5.5之前的版本允许在无效的地理矩线上设置高度。

左上角

coordinate topLeft

此属性存储了这个地理矩形的左上角坐标。

右上角

coordinate topRight

此属性存储了这个地理矩形的右上角坐标。

宽度

double width

此属性存储了这个地理矩形的宽度（以度为单位）。更多信息请参阅QGeoRectangle::setWidth。

注意： 如果地理矩形无效，则无法设置宽度。QtPositioning在Qt 5.5之前的版本允许在无效的地理矩线上设置宽度。