ArcGIS Server Rest for Javascript API 学习教程-2

上一节我们总结了Map类的一些常用属性和基本配置，那么这一节来学习一下Map的常用事件。

 

1.首先我们需要了解一下这些事件的参数evt，这个参数对原本的浏览器事件参数evt做了扩充：

增加了screenPoint, mapPoint。

但是当事件源是一个Graphic时，evt会增加一个graphic属性，表示点击的要素。

注意：map.graphics图层中的要素只有在map加载完毕后才能使用，因此如果为map.graphics图层注册点击事件，则应将代码写在map的onLoad事件中：

   代码：

dojo.connect(map, "onLoad",function() {
    dojo.connect(map.graphics,"onClick", myGraphicsClickHandler);
  });

 

2. 关于事件重复激发：

  在IE中，由于IE事件模型的原因，当元素重叠时，激发事件会做用到每一个元素上。但这对于地图来说是不必要的，比如为map和map.graphics分别注册了点击的响应函数，则当点击在graphics上时，也会激发map的click事件。

代码：

functioninit() {
  ...
  dojo.connect(map, "onClick",executeQuery);
  dojo.connect(map, "onLoad",function() {
    dojo.connect(map.graphics,"onClick", recenterMap);
  }
}
 
functionexecuteQuery(event) {
  query.geometry = event.mapPoint;
  queryTask.execute(query, ...);
}
 
functionrecenterMap(event) {
  map.centerAt(event.mapPoint);
}

以上代码执行一个task，task执行完后返回的graphic绘制到了地图上，若想避免点击此graphic时也激发map的click事件，则通过停止evt来做到。

修改recenterMap方法：

functionrecenterMap(event) {
  dojo.stopEvent(event);//这句话组织事件继续传播，因此不会被map捕捉到
  map.centerAt(event.mapPoint);
}

3.onExtentChange(extent,delta, levelChange, lod)    当前视窗内的地图范围发生变化时激发（一般是在平移或者缩放地图时激发）

参数:

extent<Extent> ：地图变化后的视窗范围

delta<Point>：The change in the x and y values from the previous extent. The Point x andy values are in screen units. This point acts as an anchor point, and this partof the map stays within the map region during the zoom process. 

levelChange：<Boolean> 当使用切片资源时，标识当前操作是否进行了缩放。若缩放为true，若平移为false

lod<LOD>：当使用切片资源时，该参数包含了当前缩放级别的详细信息

       LOD结构：

       

{
	level:当前缩放级别
	resolution:分辨率
	scale:比例尺
}

4.onLoad(map)    当第一个图层加载完毕后激发

    很多对图层的操作一定要等到地图加载完毕后才能正确执行，因为很可能会调用到相关图层的属性，而图层是异步加载的(map.addLayer)；若图层没有加载完就会找不到这些属性而引发错误。

    所以，关于对图层的操作最好这样作比较保险：

 代码：        

if (map.loaded) {
                    doAfterLoaded();//对图层的操作
                }
                else{
                    dojo.connect(map, "onLoad",doAfterLoaded);
                }

    这里利用map的loaded属性判断地图是否加载完毕，若完毕则直接执行doAfterLoaded，否则将doAfterLoaded注册给地图的onLoad事件，以确保只有在地图加载完毕后才执行doAfterLoaded.

 

5.onLayersAddResult(results)当全部图层加载后激发，可在此事件中操作已加载到地图中的全部图层

参数：

Results：<Object[]>

Object结构：

{
       <Layer> layer,//图层
       <Boolean> success,//是否加载成功
       <Error> error//若加载失败，描述失败的原因
}

6.onLayerAddResult(layer,error) ，每一个图层加载完毕后都会激发此事件