无论是前端系统,还是二维/三维GIS应用系统,都离不开各种事件的应用,尤其是鼠标的单击、双击事件。 Mars3D 内所有类 均支持事件的绑定、解绑、触发等统一的事件机制,事件类型全部定义在mars3d.EventType 。
#1. 事件的相关类
-
事件相关的更多方法可以参阅 BaseClass类 的API文档。
-
事件方法中使用到说支持的事件类型,都统一定义在mars3d.EventType 枚举中。在每个对应类的API中都会说明当前类所支持的事件类型,具体参阅各类的API文档。
下面,我们以 map对象为例,绑定一个事件做示例:
function map_cameraChangedHandler(event){
console.log('相机位置完成', event)
}
//on绑定事件
map.on(mars3d.EventType.cameraChanged, map_cameraChangedHandler, this)
//off移除事件
map.off(mars3d.EventType.cameraChanged, map_cameraChangedHandler, this)
#2. 主要类的常用事件
#2.1 Map类的事件
目前最重要的Map类支持3类事件类型可以绑定:
- Map内部图层变化时的事件,如
addLayer、removeLayer
等 - 相机、时钟、场景等变化触发的事件,如
cameraMoveStart、preUpdate、clockTick
等 - 鼠标键盘操作触发的事件,如
click、mouseMove、mouseOver、keydown
等
详细事件列表,请参阅:Map支持的事件类型
#2.2 图层类的事件
图层类型可以绑定多种事件,我们已最常用的GraphicLayer图层为例:
- 图层内部变化时的事件,如
add、show、addGraphic
等 - 鼠标操作触发的事件,如
click、rightClick、mouseOver、mouseOut
等 - 标绘和编辑触发的事件,如
drawStart、drawCreated、editStart、editStop
等
详细事件列表,请参阅:GraphicLayer支持的事件类型
#2.3 矢量数据类的事件
矢量数据类型可以绑定多种事件,我们已最常用的Entity矢量数据为例:
- 数据内部变化时的事件,如
add、remove、show
等 - 鼠标操作触发的事件,如
click、rightClick、mouseOver、mouseOut
等 - 标绘和编辑触发的事件,如
drawStart、drawCreated、editStart、editStop
等