SMap.Event
说明
- 封装了所有事件。
事件回调返回属性
mapId:String
- 当前地图的id。
overlayId:String
- overlay对象的id。
eventType:String
- 事件类型名称。
eventX:String
- 经度坐标。
eventY:String
- 纬度坐标。
zoom:Number
- Zoom级别。
measureResult:Number
- 测量的距离。
- 右键菜单项的Id。
objectType:String
- 右键菜单触发事件的对象类型。
tileLayerId:String
- 切片的Id。
bounds:SMap.LngLatBounds
- 矩形区域经纬度范围。
事件
TIP_OPEN事件
- 打开信息窗体时触发该事件。
语法
Map.addEventListener(Map,SMap.TIP_OPEN,openTip);
返回值
- 一个Event对象,它具有下列属性
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
- overlayId:String overlay对象的id,否则返回空。
示例
mapObj.addEventListener(mapObj,SMap.TIP_OPEN, openTip); function openTip(param){ alert(param.mapId+";"+param.eventType+";"+param.overlayId); }
TIP_CLOSE事件
- 关闭信息窗体时触发该事件。
语法
Map.addEventListener(Map,SMap.TIP_CLOSE,closeTip);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
- overlayId:String overlay对象的id,否则返回空。
示例
mapObj.addEventListener(mapObj,SMap.TIP_CLOSE, closeTip); function closeTip(param){ alert(param.mapId+";"+param.eventType+";"+param.overlayId); }
ADD_OVERLAY事件
- 向地图上添加覆盖层时触发该事件。
语法
Map.addEventListener(Map,SMap.ADD_OVERLAY,addOverlay);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
- overlayId:String 添加到地图上overlay对象的id。
示例
mapObj.addEventListener(mapObj, SMap.ADD_OVERLAY, addOverlay); function addOverlay(param){ alert(param.mapId+";"+param.eventType+";"+param.overlayId); }
REMOVE_OVERLAY事件
- 删除地图上覆盖物时触发该事件。
语法
Map.addEventListener(Map,SMap.REMOVE_OVERLAY,removeOverlay);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
- overlayId:String overlay对象的id。
示例
mapObj.addEventListener(mapObj,SMap.REMOVE_OVERLAY,removeOverlay); function removeOverlay(param){ alert(param.mapId+";"+param.eventType+";"+param.overlayId); }
CLEAR_OVERLAYS事件
- 同时删除地图上所有覆盖层时触发该事件。
语法
Map.addEventListener(Map,SMap.CLEAR_OVERLAYS,clearOverlays);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
示例
mapObj.addEventListener(mapObj,SMap.CLEAR_OVERLAYS,clearOverlays); function clearOverlays(param){ alert(param.mapId+"; "+param.eventType); }
MOUSE_CLICK事件
- 单击鼠标左键时触发该事件。
语法
Map.addEventListener(Map/Overlay,SMap.MOUSE_CLICK,clickMouse);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
- overlayId:String 所单击覆盖物的Id。备注:当单击覆盖物对象时还有此返回值。
- eventX:String/Number 单击点的经度坐标。
- eventY:String/Number 单击点的纬度坐标。
示例
mapObj.addEventListener(mapObj,SMap.MOUSE_CLICK,clickMouse); function clickMouse(param){ alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY); }
MOUSE_RIGHT_CLICK事件
- 单击鼠标右键时触发此事件。
语法
Map.addEventListener(Map/Overlay,SMap.MOUSE_RIGHT_CLICK,rclickMouse);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
- overlayId:String 所单击覆盖物的Id。备注:当单击覆盖物对象时还有此返回值。
- eventX:String/Number 单击点的经度坐标。
- eventY:String/Number 单击点的纬度坐标。
示例
mapObj.addEventListener(mapObj,SMap.MOUSE_RIGHT_CLICK,rclickMouse); function rclickMouse(param){ alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY); }
MOUSE_DOWN事件
- 鼠标键落下时触发该事件。
语法
Map.addEventListener(Map/Overlay,SMap.MOUSE_DOWN,mouseDown);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
- eventX:String/Number 单击点的经度坐标。
- eventY:String/Number 单击点的纬度坐标。
- overlayId:String 所单击覆盖物的Id。备注:当单击覆盖物对象时还有此返回值。
示例
mapObj.addEventListener(mapObj,SMap.MOUSE_DOWN,mouseDown); function mouseDown(param){ alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY); }
MOUSE_MOVING事件
- 在地图上移动鼠标时触发该事件。
语法
Map.addEventListener(Map,SMap.MOUSE_MOVING,mouseMoving);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
- eventX:String/Number 单击点的经度坐标。
- eventY:String/Number 单击点的纬度坐标。
示例
mapObj.addEventListener(mapObj, SMap.MOUSE_MOVING,mouseMoving); function mouseMoving(param){ alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY); }
MOUSE_UP事件
- 在地图或者覆盖物上抬起鼠标键时触发该事件。
语法
Map.addEventListener(Map/Overlay,SMap.MOUSE_UP,mouseUp);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
- eventX:String/Number 单击点的经度坐标。
- eventY:String/Number 单击点的纬度坐标。
- overlayId:String 所单击覆盖物的Id。备注:当单击覆盖物对象时还有此返回值。
示例
mapObj.addEventListener(mapObj,SMap.MOUSE_UP,mouseUp); function mouseUp(param){ alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY); }
MOUSE_OVER事件
- 鼠标移到覆盖物上时触发该事件。
语法
Map.addEventListener(Overlay,SMap.MOUSE_OVER,mouseOver);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
- overlayId:String 所单击覆盖物的Id。备注:当单击覆盖物对象时还有此返回值。
- eventX:String/Number 单击点的经度坐标。备注:当单击覆盖物对象时还有此返回值。
- eventY:String/Number 单击点的纬度坐标。备注:当单击覆盖物对象时还有此返回值。
注释
目前此事件不支持注册在地图上
示例
mapObj.addEventListener(marker,SMap.MOUSE_OVER,mouseOver);// marker为地图上已存在的点对象 function mouseOver(param) { alert(param.mapId+";"+param.eventType+";"+param.overlayId+";"+param.eventX+";"+param.eventY); }
MOUSE_OUT事件
- 鼠标移出覆盖物时触发该事件。
语法
Map.addEventListener(Overlay,SMap.MOUSE_OUT,mouseOut);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
- overlayId:String 所单击覆盖物的Id。备注:当单击覆盖物对象时还有此返回值。
- eventX:String/Number 单击点的经度坐标。备注:当单击覆盖物对象时还有此返回值。
- eventY:String/Number 单击点的纬度坐标。备注:当单击覆盖物对象时还有此返回值。
注释
目前此事件不支持注册在地图和圆形覆盖物之上
示例
mapObj.addEventListener(marker,SMap.MOUSE_OUT,mouseOut);//marker为地图上已存在的点对象 function mouseOut(param) { alert(param.mapId+";"+param.eventType+";"+param.overlayId+";"+param.eventX+";"+param.eventY); }
DRAG_START事件
- 开始拖拽地图时触发该事件。
语法
Map.addEventListener(Map,SMap.DRAG_START,startDrag);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
- eventX:String/Number 单击点的经度坐标。
- eventY:String/Number 单击点的纬度坐标。
示例
mapObj.addEventListener(mapObj,SMap.DRAG_START,startDrag); function startDrag(param){ alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY); }
DRAGGING事件
- 拖拽地图过程中触发该事件。
语法
Map.addEventListener(Map,SMap.DRAGGING,dragging);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
示例
mapObj.addEventListener(mapObj,SMap.DRAGGING,dragging); function dragging(param){ alert(param.mapId+";"+param.eventType); }
DRAG_END事件
- 拖拽地图结束时触发该事件。
语法
Map.addEventListener(Map,SMap.DRAG_END,endDrag);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
示例
mapObj.addEventListener(mapObj,SMap.DRAG_END,endDrag); function endDrag(param){ alert(param.mapId+";"+param.eventType); }
MAP_MOVE_START事件
- 地图开始移动时触发该事件。
语法
Map.addEventListener(Map,SMap.MAP_MOVE_START,startMoveMap);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
- eventX:String/Number 当前地图中心点的经度坐标。
- eventY:String/Number 当前地图中心点的纬度坐标。
示例
mapObj.addEventListener(mapObj, SMap.MAP_MOVE_START,startMoveMap); function startMoveMap(param){ alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY); }
MAP_MOVING事件
- 地图移动过程中触发该事件。
语法
Map.addEventListener(Map, SMap.MAP_MOVING, mapMoving);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
- eventX:String/Number 当前地图中心点的经度坐标。
- eventY:String/Number 当前地图中心点的纬度坐标。
示例
mapObj.addEventListener(mapObj, SMap.MAP_MOVING, mapMoving); function mapMoving(param){ alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY); }
MAP_MOVE_END事件
- 地图移动结束时触发该事件。
语法
Map.addEventListener(Map,SMap.MAP_MOVE_END,endMove);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
- eventX:String/Number 当前地图中心点的经度坐标。
- eventY:String/Number 当前地图中心点的纬度坐标。
示例
mapObj.addEventListener(mapObj,SMap.MAP_MOVE_END,endMove); function endMove(param){ alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY); }
ZOOM_START事件
- 开始缩放地图时触发该事件。
语法
Map.addEventListener(Map,SMap.ZOOM_START,startZoom);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
- eventX:String/Number 经度坐标。
- eventY:String/Number 纬度坐标。
- zoom:Number 地图缩放前的zoom级别。
示例
mapObj.addEventListener(mapObj,SMap.ZOOM_START,startZoom); function startZoom(param){ alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY+";"+param.zoom); }
ZOOM_END事件
- 缩放地图结束时触发该事件。
语法
Map.addEventListener(Map,SMap.ZOOM_END,endZoom);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
- eventX:String/Number 经度坐标。
- eventY:String/Number 纬度坐标。
- zoom:Number 地图缩放前的zoom级别。
示例
mapObj.addEventListener(mapObj,SMap.ZOOM_END,endZoom); function endZoom(param){ alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY+";"+param.zoom); }
ZOOM_CHANGED事件
- 改变地图缩放级别时触发该事件。
语法
Map.addEventListener(Map,SMap.ZOOM_CHANGED,changeZoom);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
- eventX:String/Number 经度坐标。
- eventY:String/Number 纬度坐标。
- zoom:Number 地图缩放前的级别。
示例
mapObj.addEventListener(mapObj,SMap.ZOOM_CHANGED,changeZoom); function changeZoom(param){ alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY+";"+param.zoom); }
MEASURE_STEP事件
- 测量过程中每一次单击触发该事件。
语法
Map.addEventListener(Map,SMap.MEASURE_STEP,measureStep);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
- overlayId:String :overlay对象的id。
- eventX:String/Number 经度坐标。
- eventY:String/Number 纬度坐标。
- measureResult:Number 测量的结果。
示例
mapObj.addEventListener(mapObj,SMap.MEASURE_STEP,measureStep); function measureStep(param){ alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY+";"+param. measureResult); }
MEASURE_END事件
- 测距结束时触发该事件。
语法
Map.addEventListener(Map,SMap.MEASURE_END,endMeasure);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
- overlayId:String :overlay对象的id。
- eventX:String/Number 经度坐标。
- eventY:String/Number 纬度坐标。
- measureResult:Number 测量的距离,单位为米。
示例
mapObj.addEventListener(mapObj,SMap.MEASURE_END,endMeasure); function endMeasure(param){ alert(param.mapId+";"+param.eventType+";"+overlayId+";"+param.eventX+";"+param.eventY+";"+param. measureResult); }
MENUITEM_CLICK事件
- 点击右键菜单时触发该事件。
语法
Map.addEventListener(Map,SMap.MENUITEM_CLICK,clickMenuitem);
返回值
- 一个Event对象,它具有下列属性:
- mapId:String 地图对象的名称。
- eventType:String 事件类型名称。
- overlayId:String overlay对象的id。
- menuItemId:String 右键菜单项ID。
- objectType:String 右键菜单触发事件的对象类型。
- eventX:String/Number 经度坐标。
- eventY:String/Number 纬度坐标。
示例
mapObj.addEventListener(mapObj,SMap.MENUITEM_CLICK,clickmenuitem); function clickmenuitem (param){ alert(param.mapId+";"+param.eventType+";"+param.overlayId+";"+param.menuItemId+";"+param.objectType+";"+param.eventX+";"+param.eventY); }