App Inventor2018地图组件参考手册(6)

本文介绍地图功能组件中的线(LineString)组件。

概述

线是地图上开放的线型组件，由多个线段组成。拖动任何一个线段的中间点，都可以生成一个新的顶点，点击并拖拽顶点可以移动顶点，点击某个顶点将删除该顶点。

属性

说明(Description)

说明的内容将显示在信息框中，用户点击特征点时，会弹出信息框。

允许拖拽(Draggable)

设置或读取线是否接受用户的拖拽，拖拽动作由长按并拖动完成。

启用信息框(EnableInfobox)

当用户点击特征点时，决定是否弹出信息框。

点集(Points)

线上的点的列表，列表项由经纬度组成。

点集字串(PointsFromString)

一段GeoJSON编码的字串，用来表示线上的点。在设计视图中编辑线，将改变该属性的值。

线色(StrokeColor)

线的颜色。

线宽(StrokeWidth)

线的宽度。

标题(Title)

信息框的标题，用户点击地图上的特征点时，将弹出信息框。

类型(Type)

读取特征点的类型，对于线而言，其值为“LineString”。

允许显示(Visible)

设置线在屏幕上是否可见。其值为真则可见，否则不可见。

事件

点击(Click)

当用户点击线或紧邻线的点时，触发该事件。

拖拽(Drag)

当用户拖拽线时，触发该事件。

长按(LongClick)

当用户长按线且尚未开始拖拽时，触发该事件（迫近临界点）。

开始拖拽(StartDrag)

该事件发生在拖拽开始的一刹那，之后将触发拖拽事件。

停止拖拽（StopDrag）

当用户结束拖拽，松开线时，触发该事件。

内置过程

到特征点距离(特征点,取中心点)[number DistanceToFeature(component mapFeature, boolean centroids)]

计算线到指定特征点之间的距离，如果参数取中心点的值为真，则计算两个特征点中心之间的距离，否则计算二者之间的最短距离。当线与特征点之间有重叠时，返回值为0，当发生错误时，返回-1。

到定点距离(纬度,经度,取中心点)[number DistanceToPoint(number latitude, number longitude, boolean centroids)]

计算线与定点之间的距离，定点由纬度及经度确定。当取中心点为真时，计算线的重点与定点之间的距离，否则，计算二者之间的最短距离。当定点位于线上时，返回值为0，当发生错误时，返回-1。

隐藏信息框[HideInfobox]

如果信息框可见，则隐藏信息框，否则不做任何操作。

显示信息框[ShowInfobox]

如果信息框处于隐藏状态，则显示信息框，否则不做任何操作。即便启用信息框的值为假，也可以使用该命令显示信息框。