geoRectangle QML Value Type

geoRectangle 类型表示矩形地理区域。更多

属性

• bottomLeft : geoCoordinate
• bottomRight : geoCoordinate
• center : geoCoordinate
• height : double
• topLeft : geoCoordinate
• topRight : geoCoordinate
• width : double

详细说明

geoRectangle 类型是表示矩形地理区域的geoShape 。该类型直接表示QGeoRectangle 。它由一对coordinates 定义，这对 表示矩形的左上角和右下角。坐标可通过topLeft 和bottomRight 属性获取。

如果左上角或右下角坐标无效，或者左上角坐标在右下角坐标的南边，则矩形被视为无效。

矩形四个角的坐标可通过topLeft 、topRight 、bottomLeft 和bottomRight 属性访问。center 属性可用于获取矩形中心的坐标。width 和height 属性可用于获取矩形的宽度和高度（单位：度）。设置其中一个属性会相应调整其他属性。

限制条件

地理矩形永远不能跨越两极。

如果调整了地理矩形的高度或中心，使其与某个极点相交，则会修改高度，使矩形接触但不与极点相交，并且中心坐标仍位于矩形的中心。

使用示例

要创建一个 geoRectangle 值，请使用QtPositioning.rectangle() 函数：

import QtPositioning

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

当与 C++ 整合时，请注意任何从 C++ 传入 QML 的QGeoRectangle 值都会自动转换为 geoRectangle 值，反之亦然。

属性文档