Interface (MapSignalLine)
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+Wearable26.0.0+
本文导读
导入模块
import { map, mapCommon } from '@kit.MapKit'; MapSignalLine
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+Wearable26.0.0+
信号路线管理对象，继承BaseOverlay。在调用map.MapComponentController类的addSignalLine方法时会返回该类型的实例。
模型约束： 此接口仅可在Stage模型下使用。
元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。
系统能力： SystemCapability.Map.Core
起始版本： 26.0.0
示例：
let mapSignalParams: mapCommon.MapSignalParams = {
signalId: 'signalId1'
};
mapSignalParams.points =
[{ longitude: 118.553695, latitude: 32.050789 },
{ longitude: 118.553738, latitude: 32.050884 },
{ longitude: 118.548506, latitude: 32.048543 },
{ longitude: 118.548413, latitude: 32.048374 },
{ longitude: 118.547185, latitude: 32.048252 },
{ longitude: 118.546939, latitude: 32.048296 }]
// 添加信号路线
let mapSignalLine1 = await mapController.addSignalLine(mapSignalParams); setColors
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+Wearable26.0.0+
setColors(colors: number[]): void
设置信号路线的颜色。
模型约束： 此接口仅可在Stage模型下使用。
元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。
系统能力： SystemCapability.Map.Core
起始版本： 26.0.0
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| colors | number[] | 是 | 信号路线的颜色，三个颜色分别对应弱、中、强信号，数组长度必须为3，ARGB格式，例如：[0xFF000000, 0xFFFFDF42, 0xFF42B0FF]。异常值不处理。 |
示例：
// 设置信号路线的颜色 signalLine.setColors([0xFF000000, 0xFFFFDF42, 0xFF42B0FF]);
getColors
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+Wearable26.0.0+
getColors(): number[]
获取信号路线的颜色。
模型约束： 此接口仅可在Stage模型下使用。
元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。
系统能力： SystemCapability.Map.Core
起始版本： 26.0.0
返回值：
| 类型 | 说明 |
|---|---|
| number[] | 信号路线的颜色。 |
示例：
// 获取信号路线颜色 let colors: number[] = signalLine.getColors()
setWidth
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+Wearable26.0.0+
setWidth(width: number): void
设置信号路线的宽度。
模型约束： 此接口仅可在Stage模型下使用。
元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。
系统能力： SystemCapability.Map.Core
起始版本： 26.0.0
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| width | number | 是 | 信号路线的宽度，单位：px，有效范围为：[0, 512]。异常值不处理。 |
示例：
// 设置线宽为20 signalLine.setWidth(20);
getWidth
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+Wearable26.0.0+
getWidth(): number
获取信号路线的宽度。
模型约束： 此接口仅可在Stage模型下使用。
元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。
系统能力： SystemCapability.Map.Core
起始版本： 26.0.0
返回值：
| 类型 | 说明 |
|---|---|
| number | 信号路线的宽度。 |
示例：
// 获取信号路线宽度 let width: number = signalLine.getWidth()
