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

本文介绍地图功能组件中的圆（Circle）组件。

概述

圆组件在地图上显示为一个指定半径（单位为米）的圆形，其圆心由给定的经纬度确定。修饰圆的属性有 填充色、 线色以及线宽。

圆组件可以用于地理围墙功能，即，当用户处于某一区域内时，将触发某些事件。结合位置传感器，利用内置过程 求到位置点距离，可以判断出某人位于圆内还是圆外，并据此触发其他事件，执行某段程序。

属性

说明(Description)

设置或读取显示在信息框中的说明，当用户点击圆时，会弹出信息框（前提是已启用信息框——译者注）。

允许拖拽(Draggable)

设置或读取地图的可拖拽属性，当长按圆时，可以执行拖拽操作。

启用信息框(EnableInfobox)

在启用信息框时，用户点击圆，将弹出信息框，否则信息框不会弹出。

填充色(EnableInfobox)

设置或读取圆的填充颜色。

纬度(Latitude)

置或读取圆心的纬度值，单位为角度，正值表示北半球，负值表示南半球。用内置过程 设置位置可以同时更新圆心的经纬度值。

经度(Longitude)

置或读取圆心的经度值，单位为角度，正值表示本初子午线以东，负值表示本初子午线以西。用内置过程 设置位置 可以同时更新圆心的经纬度值。

半径(Radius)

设置或读取圆的半径，单位为米。

线色(StrokeColor)

设置或读取圆周线条的颜色。

线宽(StrokeWidth)

设置或读取圆周的线宽。

标题(Title)

设置或读取信息框中的标题，当用户点击圆时，信息框弹出。

类型(Type)

读取特征点的类型，对于圆来说，其类型为“Circle”。

允许显示(Visible)

设置或读取圆组件是否显示在地图上。其值为真时，显示圆，否则隐藏圆。

事件

点击[Click]

当用户点击圆时触发该事件。

拖拽[Drag]

当圆被拖拽时，触发该事件。

长按[LongClick]

当用户长按圆但尚未触发拖拽事件时，触发该事件。注意，仅当允许拖拽为假时该事件才能被触发。

开始拖拽[StartDrag]

在拖拽开始之前触发该事件，此时可以保存圆的当前位置。

停止拖拽[StopDrag]

当拖拽结束时触发该时间，此时可以保存圆的新位置。

内置过程

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

计算圆心到其他特征点的距离，如果参数 取中心点为真，则计算两个特征点圆心之间的距离，否则，计算两个特征点之间的最短距离。当取中心点为假，且圆与特征点之间有交叉或包含时，该过程的返回值为0。当发生错误时，该过程返回值为-1。

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

计算圆到定点之间的距离,该定点由经纬度确定。如果取中心点威震，则计算圆心到定点的距离，否则，计算圆到顶点的最短距离。另，当取中心点为假时，如果定点位于圆内，则返回值为0。当发生错误时，返回值为-1。

隐藏信息框[HideInfobox]

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

设置位置(纬度,精度)[SetLocation(number latitude, number longitude)]

通过设置经纬度将圆心移动到指定位置。该方法优于单独设置经度及纬度值。

显示信息框[ShowInfobox]

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