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

本文介绍地图功能组件中的矩形(Rectangle)组件。

矩形是一个特殊的多边形，由经纬度来确定东南西北四个方向的边界，移动矩形的顶点，其边界也随之改变。

属性

说明(Description)

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

允许拖拽(Draggable)

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

东经(EastLongitude)

设置或读取举行东边界的经度值，取值范围为[-180, 180]。

启用信息框(EnableInfobox)

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

填充色(FillColor)

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

北纬(NorthLatitude)

设置或读取举行北边界的纬度值，取值范围为[-90, 90]。

南纬(SouthLatitude)

设置或读取举行南边界的纬度值，取值范围为[-90, 90]。

线色(StrokeColor)

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

线宽(StrokeWidth)

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

标题(Title)

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

类型(Type)

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

允许显示(Visible)

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

西经(WestLongitude)

设置或读取矩形西边界的经度值，取值范围为[-180, 180]。

事件

点击(Click)

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

拖拽(Drag)

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

长按(LongClick)

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

开始拖拽(StartDrag)

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

停止拖拽(StopDrag)

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

内置过程

边界列表[list Bounds]

以((北 西) (南 东))的方式返回矩形的边界（东西南北的值为经纬度）。.

形心[list Center]

以(纬度,经度)的方式返回矩形的中心。

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

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

到定点距离[number DistanceToPoint(number latitude, number longitude, boolean centroids)]

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

隐藏信息框[HideInfobox]

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

设置形心(纬度,经度)[SetCenter(number latitude, number longitude)]

将矩形的中心移动到指定的经纬度位置，并保持矩形的宽高不变。

显示信息框[ShowInfobox]

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