MapPolyline QML 类型

MapPolyline 类型在地图上显示折线。更多...

导入声明	import QtLocation 6.7
自	QtLocation 5.0

所有成员列表，包括继承成员
MapPolyline 是 QML Maps 插件的一部分。

属性

autoFadeIn : bool
线
- line.color : 颜色
- line.width : int
path : list<coordinate>
referenceSurface : 枚举 (自 6.5)

方法

void addCoordinate(coordinate)
coordinate containsCoordinate(coordinate) (自 QtLocation 5.6)
coordinate coordinateAt(index) (自 QtLocation 5.6)
void insertCoordinate(index, coordinate) (自 QtLocation 5.6)
int pathLength() (自 QtLocation 5.6)
void removeCoordinate(coordinate)
void removeCoordinate(index) (自 QtLocation 5.6)
void replaceCoordinate(index, coordinate) (自 QtLocation 5.6)
void setPath(geopath path)

详细描述

MapPolyline 类型在地图上显示折线，以有序列表中的坐标为设定。路径上的坐标一旦添加到折线后就不能直接更改。相反，将 path 复制到一个变量中，修改副本然后将副本重新分配回 path。

var path = mapPolyline.path;
path[0].latitude = 5;
mapPolyline.path = path;

可以使用 addCoordinate 和 removeCoordinate 方法在任意时刻添加和删除坐标。

默认情况下，折线以1像素的黑色线条显示。这可以通过使用 line.width 和 line.color 属性进行更改。

使用示例

以下代码示例展示了包含4个点的MapPolyline，在澳大利亚布里斯班附近形成类似于问号（?）上部的形状。绘制的线条宽度为3像素，颜色为绿色。

Map {
    MapPolyline {
        line.width: 3
        line.color: 'green'
        path: [
            { latitude: -27, longitude: 153.0 },
            { latitude: -27, longitude: 154.1 },
            { latitude: -28, longitude: 153.5 },
            { latitude: -29, longitude: 153.5 }
        ]
    }
}

属性文档

autoFadeIn : bool

此属性决定当从非常低的缩放级别缩放到地图时，项目是否自动淡入。默认情况下为 true。将此属性设置为 false 将导致地图项目始终具有与 QtQuick::Item::opacity 属性指定的不透明度，默认为1.0。

线条组
line.color : 颜色
line.width : int

此属性是线条属性组的一部分。线条属性组包含用于绘制线条的宽度和颜色。

宽度以像素为单位，与地图的缩放级别无关。默认值对应于1像素宽的黑色边框。

不绘制线条时，使用宽度为0或透明颜色。

path : 列表<坐标>

此属性包含定义折线的坐标的有序列表。

referenceSurface : 枚举 [自6.5以来]

此属性决定折线的参考表面。如果设置为 QLocation::ReferenceSurface::Map，则折线的顶点在地图上用直线连接。如果设置为 QLocation::ReferenceSurface::Globe，则顶点按照大圆路径连接，描述球面上两点的最短连接。默认值为 QLocation::ReferenceSurface::Map。

此属性是在Qt 6.5中引入的。

方法文档

void addCoordinate(coordinate)

将指定的 coordinate 添加到路径的末尾。

另请参阅insertCoordinate、removeCoordinate 和 path。

[自QtLocation 5.6以来] coordinate containsCoordinate(coordinate)

如果给定的 coordinate 是路径的一部分，则返回 true。

此方法是在QtLocation 5.6中引入的。

[自QtLocation 5.6以来] coordinate coordinateAt(index)

获取给定 index 的折线坐标。如果索引超出路径的范围，则返回无效坐标。

此方法是在QtLocation 5.6中引入的。

[自QtLocation 5.6以来] void insertCoordinate(index, coordinate)

在给定的 index 上插入 coordinate。

此方法是在QtLocation 5.6中引入的。

另请参阅addCoordinate、removeCoordinate 和 path。

[自QtLocation 5.6以来] int pathLength()

返回折线的坐标数量。

此方法是在QtLocation 5.6中引入的。

另请参阅path。

void removeCoordinate(coordinate)

从路径中移除coordinate。如果存在多个相同的坐标，将移除最后添加的一个。

如果coordinate不在路径中，则此方法不执行任何操作。

另请参阅addCoordinate、insertCoordinate和path。

[since QtLocation 5.6] void removeCoordinate(index)

根据给定的index从路径中移除一个坐标。

如果index无效，则此方法不会执行任何操作。

此方法是在QtLocation 5.6中引入的。

另请参阅addCoordinate、insertCoordinate和path。

[since QtLocation 5.6] void replaceCoordinate(index, coordinate)

使用新的coordinate替换当前路径在给定的index处的坐标。

此方法是在QtLocation 5.6中引入的。

另请参阅addCoordinate、insertCoordinate、removeCoordinate和path。

void setPath(geopath path)

使用geopath类型设置path。

另请参阅path。