ArcEngine 9.3 学习笔记(四)：地图和地图布局（Map对象，FeatureLayer对象，矢量图层操作实例）

3.1 地图

3.1.1 Map 对象

　　Map对象：在Map对象上能显示的图形有两类，一类是 地理数据，一类是 元素。
　　地理数据包括 矢量类型的要素数据、栅格数据、Tin等表面数据等；这些数据都保存在Geodatabase或数据文件如shapefile中，它们是用于GIS分析制图的源数据。
　　元素，是一种可以显示在Map上的对象，它分为：图形元素和框架元素。图形元素可以显示出来；而框架元素充当了“容器”的角色。　　

　　在Map上所画的 圆形、矩形、在布局视图上添加的 指北针、图例、比例尺等图形对象，都是图形元素；在ArcMap中Map对象是由MXDocument对象的MapFrame对象管理，MapFrame是一个框架元素

　　Map对象有双重身份：一方面是数据的管理容器，可以加载地理数据和图形元素，扮演了数据管理器的角色；另一方面，它又可以让用户看到这些数据，即扮演了数据显示器的角色。当加载数据到Map对象的时候，Map对象是数据的管理者；当改变视图范围，刷新地图的时候他是数据的显示者。

　　Map对象主要实现的接口有：IMap，IGraphicContainer，IActiveVIew，IMapBookmark等接口。
　　IMap接口主要用于管理Map对象中的Layer对象，要素选择集对象，MapSourround对象，空间参考等对象。
　　Map对象可以显示图形元素（Graphics Element），Map对象通过IGRaphicsContainer接口来管理这些元素对象，包括图形元素和框架元素。
　　IGRaphicsContainer 返回的是Map对象中处于活动状态的GRaphics Layer引用指针，它可以是一个Basicgraphicslayer，也可以是CompositeGraphicsLayer中的一个图层；或者是一个FDOGraphicsLayer注记图层。
　　以下代码片段压实如何添加一个Element到Map上

        /// <summary>
        /// 添加临时元素到地图窗口上
        /// </summary>
        /// <param name="pMapCtrl">地图控件</param>
        /// <param name="pEle">单个元素</param>
        /// <param name="pEleColl">元素集合</param>
        public void AddTempElement(AxMapControl pMapCtrl, IElement pEle, IElementCollection pEleColl)
        {
            try
            {
                IMap pMap = pMapCtrl.Map;
                IGraphicsContainer pGCs = pMap as IGraphicsContainer;

                if (pEle != null)
                {
                    pGCs.AddElement(pEle, 0);
                }
                if (pEleColl != null)
                {
                    if (pEleColl.Count > 0)
                    {
                        pGCs.AddElements(pEleColl, 0);
                    }
                }
                IActiveView pAV = (IActiveView)pMap;
                // 需要刷新才能即时显示
                pAV.PartialRefresh(esriViewDrawPhase.esriViewGraphics, null, pAV.Extent);//PartialRefresh 局部刷新
            }
            catch (Exception)
            {
                throw;
            }
        }

　　IActiveView接口定义了Map对象的数据显示功能。使用该接口可以改变视图的范围，刷新视图；
　　IActiveView 的PartialRefresh方法的不同参数，所代表的不同功能（刷新视图）：
        1）PartialRefresh(esriViewGeography,pLayer,null);// 用于刷新 --指定图层--
        2）PartialRefresh(esriViewGeography,null,null);// 用于刷新 --所有图层--
        3）PartialRefresh(esriViewGeoSelection,null,null);// 用于刷新 --所选对象--
        4）PartialRefresh(esriViewGraphicSelection,null,null);// 用于刷新 --所选择的图元--
        5）PartialRefresh(esriViewGraphics,pElement,null);// 用于刷新 --指定图形元素--
        6）PartialRefresh(esriViewGraphics,null,null);// 用于刷新 --所有图形元素--

　　IMapBookmark接口用于管理所有的空间书签对象

3.2.1 图层对象

         Map对象可以装载地理数据，这些数据以图层的形式加载到地图对象上的，图层对象Layer作为一个数据的“中介”存在，它本身没有转载地理数据；
         而仅仅是获得了数据的引用，用于管理数据源的连接。地理数据始终保持在Geodatabase或者地理数据文件中。
         由于地理数据的类型多样，所以Layer类拥有众多子类。接下来主要给大家介绍要素图层--FeatureLayer对象。

3.1.3 FeatureLayer对象

　　FeatureLayer类实现的常用主要接口有：IFeatureLayer, IFeatureLayerDefinition, FeatureSelection, IGeoDataset, IGeoFeatureLayer, IIdentify, ILayerEffects。

         IFeatureLayer接口主要用于设置要素图层的数据源（FeatureClass)，IFeatureLayer的DataSoruceType获取FeatureLayer对象的数据源类型。此外通过Search方法，可以查询要素图层上符合某一条件的要素集。

         IGeoFeatureLayer即可继承了ILayer和IFeatureLayer两个接口，用于控制要素图层的符号化和标注等
         IGeoDataset接口仅有两个属性，它们用于管理地理要素集。
         1）Extent可以返回当前数据集的范围，是一个IEnevelope类型的对象；
         2）SpatialReference属性则可以让用户获得这个数据集的空间参考

         IFeatureSelection接口提供管理一个图层中的要素的选择集的方法和属性
         以下代码片段演示了如何获取要素图层符合条件的选择集：

        /// <summary>
        /// 获取要素图层符合条件的选择集
        /// </summary>
        /// <param name="pFeatureLayer">要素图层</param>
        /// <param name="whereClause">过滤条件</param>
        /// <returns></returns>
        public IFeatureSelection SelectLayersFeatures(IFeatureLayer pFeatureLayer, string whereClause)
        {
            IFeatureSelection pFeatureSelection = pFeatureLayer as IFeatureSelection;
            if (pFeatureSelection == null)
            {
                return null;
            }

            IQueryFilter pQueryFilter = new QueryFilterClass();
            pQueryFilter.WhereClause = whereClause;
            // pFeatureSelection由pFeatureLayer QI 获得，包含pFeatureLayer中的所有要素，
            // 通过过滤器 将满足条件的 要素过滤出来，执行完SelectFeatures后，pFeatureLayer中就剩下满足条件的要素了
            pFeatureSelection.SelectFeatures(pQueryFilter, esriSelectionResultEnum.esriSelectionResultNew, false);
            return pFeatureSelection;
        }

　　IFeatureLayerDefinition接口定义了CreateSelectionLayer方法，可以将一个图层选择集中的要素转换为一个单独的要素图层。

3.1.4 矢量图层操作实例

　　以下代码片段演示按行政区加载图层数据的功能，以此理解IFeatureLayerDefinition 的CreateSelectionLayer方法的使用。

　　使用IFeatureLayerDefinition的CreateSelectionLayer方法，将选择集生成一个新图层。

        /// <summary>
        /// 按行政区范围创建行政区范围的图层
        /// </summary>
        /// <param name="pFeatureLayer">源数据图层</param>
        /// <param name="pGeometry">行政区范围</param>
        /// <param name="bXZQ">图层是否为行政区</param>
        /// <returns>新创建的图层</returns>
        public IFeatureLayer GetSelectionLayer(IFeatureLayer pFeatureLayer, IGeometry pGeometry, bool bXZQ)
        {
            try
            {
                if (pFeatureLayer != null && pGeometry != null)
                {
                    IQueryFilter pQueryFilter;
                    ISpatialFilter pSpatialFilter = new SpatialFilterClass();// 空间过滤器
                    IFeatureSelection pFeatureSelection = pFeatureLayer as IFeatureSelection;// 将源数据 当做一个选择集，再从中筛选出需要的
                    pSpatialFilter.GeometryField = pFeatureLayer.FeatureClass.ShapeFieldName;// 设置图形域为源数据要素类的图形域
                    pFeatureSelection.Clear();
                    if (!bXZQ)
                    {
                        pSpatialFilter.Geometry = pGeometry;// 设置图形过滤器的形状
                        // 如果遇到行政区层，必须设置此参数，否则这个行政区图层就不能只获取指定的省份，会把相邻的省份也添加创建到新图层
                        // 应该是去掉相邻行政区的意思
                        pSpatialFilter.SpatialRel = esriSpatialRelEnum.esriSpatialRelIndexIntersects;
                        pQueryFilter = pSpatialFilter;
                        // 进行过滤，貌似必须使用IQueryFilter接口，才能进行IFeatureSelection的过滤，但是需要图形过滤器来设置参数
                        pFeatureSelection.SelectFeatures(pQueryFilter, esriSelectionResultEnum.esriSelectionResultNew, false);
                    }
                    else
                    {
                        pSpatialFilter.SpatialRel = esriSpatialRelEnum.esriSpatialRelContains;
                        pQueryFilter = pSpatialFilter;
                        if (pGeometry is IGeometryCollection)
                        {
                            for (int i = 0; i < (pGeometry as IGeometryCollection).GeometryCount; i++)
                            {
                                pSpatialFilter.Geometry = (pGeometry as IGeometryCollection).get_Geometry(i);
                                pFeatureSelection.SelectFeatures(pSpatialFilter, esriSelectionResultEnum.esriSelectionResultAdd, false);
                            }
                        }
                    }


                    IFeatureLayerDefinition pFLDefinition = pFeatureLayer as IFeatureLayerDefinition;
                    // 由于之前 将pFeatureLayer QI 到了 pFeatureSelection, 而之后对pFeatureSelection进行了过滤，
                    // 因此目前  pFeatureLayer中的要素已经是经过了过滤的结果了；在QI 到pFLDefinition ，执行CreateSelectionLayer 创建新图层
                    IFeatureLayer pNewFeatureLayer = pFLDefinition.CreateSelectionLayer(pFeatureLayer.Name, true, null, null);
                    pNewFeatureLayer.MaximumScale = pFeatureLayer.MaximumScale;
                    pNewFeatureLayer.MinimumScale = pFeatureLayer.MinimumScale;
                    pNewFeatureLayer.Selectable = pFeatureLayer.Selectable;
                    pNewFeatureLayer.Visible = pFeatureLayer.Visible;
                    pNewFeatureLayer.ScaleSymbols = pFeatureLayer.ScaleSymbols;

                    return pNewFeatureLayer;
                }
            }
            catch (Exception)
            {
                return null;
            }
            return null;
        }

　　IIdentify 接口定义了获得要素图层单个要素的属性
　　ILayerFields接口可以直接获取一个要素图层的要素类字段集合
　　ILayerEffects接口用来设置一个要素图层的亮度，透明度，对比度。以下代码片段延时如何设置要素图层特效。

        /// <summary>
        /// 设置图层特效
        /// </summary>
        /// <param name="pFeatureLayer">要素图层</param>
        /// <param name="brightness">亮度</param>
        /// <param name="contrast">对比度</param>
        /// <param name="transparency">透明度</param>
        public void SetLayerEffects(IFeatureLayer pFeatureLayer, short brightness, short contrast, short transparency)
        {
            ILayerEffects pLayerEffect = pFeatureLayer as ILayerEffects;
            pLayerEffect.Brightness = brightness;
            pLayerEffect.Contrast = contrast;
            pLayerEffect.Transparency = transparency;
        }