SMap.Event

跳转到: 导航, 搜索

目录

说明

封装了所有事件。

事件回调返回属性

mapId:String

当前地图的id。

overlayId:String

overlay对象的id。

eventType:String

事件类型名称。

eventX:String

经度坐标。

eventY:String

纬度坐标。

zoom:Number

Zoom级别。

measureResult:Number

测量的距离。

menuItemId:String

右键菜单项的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);
}