MapCircle QML 类型

MapCircle 类型在地图上显示地理圆圈。 更多信息...

导入语句import QtLocation 6.7
QtLocation 5.5

属性

详细描述

MapCircle 类型在地图上显示地理圆圈,包括距离中心点一定距离的所有点。根据地图投影,地理圆圈不总是屏幕上的完美圆形:例如,在墨卡托投影中,圆圈在接近两极时会变成椭圆形。要在一个点周围显示完美的屏幕圆形,请使用包含相关 Qt Quick 类型的 MapQuickItem

默认情况下,圆圈以 1 个像素的黑色边框显示,没有填充色。要更改其外观,请使用 colorborder.colorborder.width 属性。

内部,MapCircle 以多边形的形式实现。它计算半径点时使用类似于 coordinate 类型的 atDistanceAndAzimuth 方法的球面模型。这两个事物偶尔会影响圆圈的形状精度,具体取决于位置和地图投影。

注意:拖动一个 MapCircle(通过使用 MouseAreaPointHandler)会在以同一距离(米为单位)从中心点生成新点。这与存储以顶点之间纬度和经度差异为维度尺寸的其他地图项形成对比。

示例用法

以下代码片段显示一个包含 MapCircle 的地图,中心坐标为 (-27, 153),半径为 5 公里。圆圈以绿色填充,边框宽度为 3 个像素。

Map {
    MapCircle {
        center {
            latitude: -27.5
            longitude: 153.0
        }
        radius: 5000.0
        color: 'green'
        border.width: 3
    }
}

属性文档

autoFadeIn : 布尔值

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


边框组

border.color : 颜色

border.width : 整数

此属性是边框组属性的一部分。边框属性保存绘制圆边框时使用的宽度和颜色。宽度以像素为单位,不受地图缩放级别的影响。

默认值对应一个 1 像素宽的黑边框。对于没有线条的情况,请使用宽度为 0 或透明颜色。


center : 坐标

此属性保存圆中央的点,该圆据此定义。

另请参阅 radius.


color : 颜色

此属性保存绘图时圆的填充颜色。对于不填充,请使用透明颜色。


opacity : 实数

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

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


radius : 实数

此属性保存地面上的圆的半径,以米为单位。

另请参阅 center.


referenceSurface : 枚举 [since 6.5]

此属性确定圆的参考表面。如果将其设置为 QLocation::ReferenceSurface::Map,则圆将在地图上以 radius 近似匹配圆心的地图比例绘制为一个圆。如果将其设置为 QLocation::ReferenceSurface::Globe,则圆将被映射到球面上,并使用大圆路径来确定圆的范围。默认值为 QLocation::ReferenceSurface::Map

此属性自 Qt 6.5 版本引入。


© 2024 Qt 公司有限公司。此处包含的文档贡献是各自所有者的版权。此处提供的文档根据自由软件基金会发布的 GNU 自由文档许可证版本 1.3 的条款许可。Qt 和相应的标志是芬兰和/或其他国家的 Qt 公司的商标。所有其他商标均为各自所有者的财产。