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

本文介绍地图功能组件中的多边形（Polygon）组件。

概述

多边形是地图上一个封闭的任意形状的区域，可以用于划定一个边界，如校园、城市、国家等等。边数最小的多边形是三角形。添加多边形顶点的方法很简单，在设计视图中，拖拽一条边的中点，就可以拉出一个顶点，而点击一个顶点将删除该顶点，不过，顶点数始终不能小于3。

属性

说明(Description)

设置或读取信息框中的说明文字，当启用信息框时，用户点击标记，将弹出信息框窗口。

允许拖拽(Draggable)

该属性决定用户是否可以在长按多边形后将其移动到新的位置。

启用信息框(EnableInfobox)

该属性决定用户点击标记时，是否弹出信息框。

填充色(FillColor)

设置或读取填充多边形的颜色。

内边界点(HolePoints)

设置或读取构成中空多边形内边界的点的列表，列表项由经纬度列表组成，按逆时针方向排列。

内边界点字串(HolePointsFromString)

设置或读取内边界点列表，字串数据的格式为GeoJSON。

边界点(Points)

设置或读取组成多边形的顶点列表。这些点由经纬度对(纬度,经度)组成，沿顺时针方向排列。

边界点字串(PointsFromString)

利用GeoJSON格式的字串生成边界点列表。

线色(StrokeColor)

设置或读取多边形轮廓线的颜色。

线宽(StrokeWidth)

设置或读取多边形轮廓线的宽度。

标题(Title)

设置或读取信息框中的标题。当用户点击地图上的特征点时，将弹出信息框。

类型(Type)

设置或读取特征点的类型，对多边形而言，其值为“Polygon”。

允许显示(Visible)

设置或读取标记是否可见。若其值为真，则显示标记，否则隐藏标记。

事件

点击(Click)

当用户点击多边形时触发该事件。

拖拽(Drag)

当用户拖拽多边形时，连续触发该事件。

长按(LongClick)

当用户长按多边形但未触发拖拽事件时，触发该事件。注意，仅当允许拖拽的属性值为假时，才能触发该事件。

开始拖拽(StartDrag)

当拖拽操作开始时，触发该事件。

停止拖拽(StopDrag)

当拖拽操作结束时，触发该事件。

内置过程

形心坐标[list Centroid]

以(纬度,经度)的形式返回多边形的形心坐标。

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

计算多边形到特征点之间的距离。当参数取中心点为真时，计算二者中心点之间的距离，否则，计算二者之间的最短距离。如果取中心点的值为假，且多边形包含特征点，或与之重叠，则返回值为0，如果发生错误，则返回值为-1。

到定点距离[number DistanceToPoint(number latitude, number longtitude, boolean centroid)]

计算多边形到指定经纬度的定点之间的距离。当参数取中心点为真时，计算多边形形心到定点的距离，否则，计算两者之间的最短距离。另，当取中心点的值为假，且顶点位于多边形内部时，返回值为0，当发生错误时，返回值为-1。

隐藏信息框[HideInfobox]

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

显示信息框[ShowInfobox]

如果信息框处于隐藏状态，则显示信息框，否则不做任何操作。注意，即便启用信息框的属性值为假，该过程也可以让信息框显示出来。