MapRectangle QML 类型

MapRectangle 类型可以在地图上显示一个矩形。 更多信息...

导入声明import QtLocation 6.7
自从QtLocation 5.5

属性

详细描述

MapRectangle 类型可以在地图上显示一个矩形。矩形是多边形的一种特殊情况,恰好有 4 个顶点和 4 条“直线”边。在这种情况下,“直线”意味着左上点的纬度与右上点的纬度相同(顶部边缘),且左下点的纬度与右下点的纬度相同(底部边缘)。类似地,左侧的点具有相同的经度,而右侧的点也具有相同的经度。

要指定矩形,它需要一个 topLeftbottomRight 点,这两个点都由一个 coordinate 提供。

默认情况下,矩形以透明的填充和 1 像素厚的黑色边框显示。可以此使用 colorborder.colorborder.width 属性进行更改。

注意:MapPolygon 类型类似,MapRectangles 是地理项目,因此拖动 MapRectangle 会导致其在地理坐标空间中重新计算顶点。当拖动到不同纬度时,项目会显得伸展,但其边缘仍保持直线。

示例用法

以下片段演示了一个包含 MapRectangle 的地图示例,范围为 (-27, 153) 到 (-28, 153.5),靠近澳大利亚的布里斯班。矩形用绿色填充,并有 2 像素的黑边。

Map {
    MapRectangle {
        color: 'green'
        border.width: 2
        topLeft {
            latitude: -27
            longitude: 153
        }
        bottomRight {
            latitude: -28
            longitude: 153.5
        }
    }
}

属性文档

autoFadeIn : bool

此属性表示从非常低的缩放级别开始放大地图时,项目是否自动淡入。默认情况下,此值为true。将此属性设置为false将使地图项目始终具有由QtQuick::Item::opacity属性指定的不透明度,默认值为1.0。


边框组

border.color : 颜色

border.width : 整型

此属性是边框属性组的一部分。边框属性组包含用于绘制矩形边框的宽度和颜色。宽度以像素为单位,与地图的缩放级别无关。

默认值对应于1像素宽的黑色边框。要使用无边线,请使用宽度为0或透明颜色。


bottomRight : 坐标

此属性保存MapRectangle的右下角坐标,可以用来获取其经度、纬度和高度。


color : 颜色

此属性保存矩形的填充颜色。如无需填充,请使用透明颜色。


opacity : 实型

此属性保存项目的不透明度。不透明度指定为介于0(完全透明)和1(完全不透明)之间的数字。默认值为1。

透明度为0的项目仍然会接收到鼠标事件。要停止鼠标事件,请将项目的可视属性设置为false。


referenceSurface : 枚举 [自6.5版引入]

此属性确定矩形的参考表面。如果设置为QLocation::ReferenceSurface::Map,则地图上的边点使用直线连接。如果设置为QLocation::ReferenceSurface::Globe,则边点根据大圆路径连接,描述了球面上两点之间的最短连接。默认值为QLocation::ReferenceSurface::Map

此属性自Qt 6.5版引入。


topLeft : 坐标

此属性保存MapRectangle的左上角坐标,可以用来获取其经度、纬度和高度。


© 2024 Qt公司。本文件中的文档贡献属于其各自的版权所有者。本文件提供的文档是根据自由软件基金会发布的自由文档许可版本1.3条款许可的。和相关标志是芬兰的Qt公司以及世界各地的商标。所有其他商标均为其各自所有者的财产。