MapRectangle QML 类型
MapRectangle 类型可以在地图上显示一个矩形。 更多信息...
导入声明 | import QtLocation 6.7 |
自从 | QtLocation 5.5 |
- 所有成员列表,包括继承成员
- MapRectangle 是 QML Maps 插件的一部分。QML Maps Plugin.
属性
- autoFadeIn : bool
- border
- border.color : color
- border.width : int
- bottomRight : coordinate
- color : color
- opacity : real
- referenceSurface : enum
(since 6.5)
- topLeft : coordinate
详细描述
MapRectangle 类型可以在地图上显示一个矩形。矩形是多边形的一种特殊情况,恰好有 4 个顶点和 4 条“直线”边。在这种情况下,“直线”意味着左上点的纬度与右上点的纬度相同(顶部边缘),且左下点的纬度与右下点的纬度相同(底部边缘)。类似地,左侧的点具有相同的经度,而右侧的点也具有相同的经度。
要指定矩形,它需要一个 topLeft 和 bottomRight 点,这两个点都由一个 coordinate 提供。
默认情况下,矩形以透明的填充和 1 像素厚的黑色边框显示。可以此使用 color、border.color 和 border.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。
此属性是边框属性组的一部分。边框属性组包含用于绘制矩形边框的宽度和颜色。宽度以像素为单位,与地图的缩放级别无关。
默认值对应于1像素宽的黑色边框。要使用无边线,请使用宽度为0或透明颜色。
bottomRight : 坐标 |
此属性保存MapRectangle的右下角坐标,可以用来获取其经度、纬度和高度。
color : 颜色 |
此属性保存矩形的填充颜色。如无需填充,请使用透明颜色。
opacity : 实型 |
此属性保存项目的不透明度。不透明度指定为介于0(完全透明)和1(完全不透明)之间的数字。默认值为1。
透明度为0的项目仍然会接收到鼠标事件。要停止鼠标事件,请将项目的可视属性设置为false。
referenceSurface : 枚举 |
此属性确定矩形的参考表面。如果设置为QLocation::ReferenceSurface::Map,则地图上的边点使用直线连接。如果设置为QLocation::ReferenceSurface::Globe,则边点根据大圆路径连接,描述了球面上两点之间的最短连接。默认值为QLocation::ReferenceSurface::Map。
此属性自Qt 6.5版引入。
topLeft : 坐标 |
此属性保存MapRectangle的左上角坐标,可以用来获取其经度、纬度和高度。
© 2024 Qt公司。本文件中的文档贡献属于其各自的版权所有者。本文件提供的文档是根据自由软件基金会发布的