本文介绍标记(Marker)组件。 概述 标记组件用于在地图上标记位置点,如一座建筑物,或兴趣点等。有多种方式设置标记的图标,例如,可以将上传到项目中的图片文件设置为标记点的图标,也可以使用创建标记内置过程来动态创建标记,并使用组件类代码块来设置标记的属性。 属性 水平对齐(AnchorHorizontal) 设置或读取标记中心点与图片之间的水平对齐方式,有三个可选项:居左、居右及居中。 垂直对齐(AnchorVertical) 设置或读取标记中心点与图片之间的垂直对齐方式,有三个可选项:居上、居下及居中对齐。 说明(Description) 设置或读取信息框中的说明文字,当启用信息框时,用户点击标记,将弹出信息框窗口。 允许拖拽(Draggable) 该属性决定用户是否可以在长按标记后将标记移动到新的位置。 启用信息框(EnableInfobox) 该属性决定用户点击标记时,是否弹出信息框。 填充色(FillColor) 设置或读取填充标记的颜色。该属性只适用于矢量图,也包括默认的标记图标。 高度(Height) 设置或读取标记的高度,单位为像素。 高度百分数(HeightPercent) 设置标记的高度占屏幕高度的百分比。 图片(ImageAsset) 设置或读取用于显示标记的图片。如果其取值为"empty-string"(空字串),则采用的是默认图标。 纬度(Latitude) 设置或读取标记位置的纬度值,单位为角度,赤道以北为正值,以南为负值,使用设置位置(SetLocation)内置过程可以同时设置标记的经纬度。 经度(Longitude) 设置或读取标记位置的经度值,单位为角度,0度经线以东为正值,以西为负值,使用设置位置(SetLocation)内置过程可以同时设置标记的经纬度。 线色(StrokeColor) 设置或读取标记轮廓线的颜色。 线宽(StrokeWidth) 设置或读取标记轮廓线的宽度。 标题(Title) 设置或读取信息框中的标题。当用户点击标记时, 将弹出信息框(前提是启用信息框)。 类型(Type) 设置或读取特征点的类型,对标记而言,其值为“marker”。 允许显示(Visible) 设置或读取标记是否可见。若其值为真,则显示标记,否则隐藏标记。 宽度(Width) 设置或读取标记的宽度,单位为像素。 宽度百分数(WidthPercent) 设置标记的宽度占屏幕宽度的百分比。 事件 点击 当用户点击标记时触发该事件。 拖拽 当用户拖拽标记时,连续触发该事件。 长按 当用户长按标记但尚未触发拖拽事件时,触发该事件。注意,仅当允许拖拽的属性值为假时,才能触发该事件。 开始拖拽 当拖拽操作开始时,触发该事件。 停止拖拽 当拖拽操作结束时,触发该时间。 内置过程 特征点方位(特征点,取中心点)[number BearingToFeature(component mapFeature, boolean centroids)] 返回从标记到指定特征点的方位,单位为角度,以正北为0度,顺时针为正方向。当参数取中心点为真时,方位置向特征点的中心,否则指向距标记最近的点。 位置点方位(纬度,经度,取中心点)[number BearingToPoint(number latitude, number longitude, boolean centroids)] 返回从标记到指定位置的方位,单位为角度,以正北为0度,顺时针为正方向。 到特征点距离(特征点,取中心点)[number DistanceToFeature(component mapFeature, boolean centroids)] 计算标记点到特征点至iande距离。当参数取中心点为真时,计算从标记到特征点中心的距离,否则,计算从标记到特征点的最短距离,此时如果标记与特征点重合,或相互包含,则返回值为0,如果发生错误,则返回值为0。 到定点距离(纬度,经度,取中心点)[number DistanceToPoint(number latitude, number longitude, boolean centroids)] 计算标记到指定经纬度的定点之间的距离。当参数取中心点为真时,计算圆心到定点的距离,否则,计算两者之间的最短距离。当两者重叠时,返回值为0,当发生错误时,返回值为-1。(该过程返回值与参数取中心点无关——译者注) 隐藏信息框[HideInfobox] 当信息框可见时,隐藏信息框,否则不做任何操作。 设置位置(纬度,经度)[SetLocation(number latitude, number longitude)] 将标记点移动至指定经纬度的位置。该过程比单独设置纬度及经度更有效率。 显示信息框[ShowInfobox] 如果信息框处于隐藏状态,则显示信息框,否则不做任何操作。注意,即便启用信息框的属性值为假,该过程也可以让信息框显示出来。 |
|