ArcEngine 9.3 学习笔记(五)：地图和地图布局（PageLayout对象,Page对象,SnapGrid对象,SnapGuides对象，Element 对象，MapGrid 对象..._arcengine布局视图-程序员宅基地

3.2 地图布局

3.2.1 PageLayout对象

　　PageLayout用于显示地图数据，并通过对地图数据进行整饰以便对地图打印输出满足不同行业对GIS出图功能的需求。
　　PageLayout和Map这两个对象看起来非常相似，他们都是视图对象，可以显示地图；也都是图形元素的容器，可以容纳图形元素（Graphics Element）
　　区别：PageLayout除了保存图形元素外，还可以保存诸如MapFrame的框架元素（Frame Element）。
　　PageLayout控件上的Map对象被PageLayout的MapFrame对象所管理

　　PageLayout 类主要实现了IPageLayout接口，它定义了用于修改页面板式（layout）的方法和属性
　　IPageLayout的ZoomToWhole方法可以让PageLayout以最大尺寸显示；
　　IPageLayout 的ZoomToPercent方法可以按照输入的比例显示；
　　IPageLayout的ZoomToWidth方法可以让视图显示的范围匹配控件对象的宽度
　　IPageLayout的Page属性用以获取Page对象
　　IPageLayout的RulerSettings属性用以获取RulerSettings对象
　　IPageLayout的HorizontalSnapGuides和VerticalSnapGuides属性可以获取SnapGuides对象

3.2.2 Page对象
　　主要用来管理PageLayout对象中的页面，它用来加载地理数据，但不提供分析和查询功能。
　　Page类的主要接口是IPage，它除了用于管理Page的颜色、尺寸和方向，还可以管理边框类型和打印区域。FromID可以设置纸张大小类型

3.2.3 SnapGrid对象
　　是PageLayout上用于摆放元素而设置的辅助点。

　　以下代码片段演示 如何 设置PageLayout控件上的ISnapGrid

View Code

3.2.4 SnapGuides对象

　　SnapGuides对象，是为了更好的放置地图，而在PageLayout上设置的辅助线；同样分为 水平和垂直两种。

　　ISnapGuides 的AreVisible设定SnapGuides是否可见。

　　ISnapGuides 的GuideCount属性返回一个SnapGuides对象中的Guide的个数。

　　而使用ISnapGuides的Guide属性可以按索引值获得某个具体的Guide对象。

　　ISnapGuides的AdGuide方法将一个Guide放在指定位置上。

　　ISnapGuides的RemoveAllGuides和RemoveGuide方法分别可以清除所有的Guide和按索引值清除Guide。

　　以下代码片段演示如何为PageLayout对象添加辅助线：

View Code

 3.2.5 RulerSettings 对象

　　标尺对象，它是为了辅助图形元素的放置位置而出现在Pagelayout对象上方和左方的辅助尺；通过IPageLayout的RulerSetting属性可以获得PageLayout上的RulerSetting对象；IRulerSetting接口的SmallestDivision属性用于设置标尺对象的最小刻度值属性。

3.2.6 Element 对象

　　在Map对象和Pagelayout对象显示的数据，除了地理数据外，还有 元素数据Element
　　Element 是一个非常庞大复杂的对象集合：a 图形元素（GraphicElement）和框架元素（FrameElement）
　　图形元素包括：LineElement,MarkerElement,TextElemet,GroupElement,FillshapElement,PictureElement,MultiPatchElement等
　　这些元素都是以图形的形式存在，在地图视图或者PageLayout视图上是可见的。
　　框架元素包括：MapFrameElement（地图框架元素），MapSurroundElement（地图环绕元素） 等，它们是作为不可见的容器存在的

　　Map对象或者Pagelayout对象可以通过IGraphicsContainer 接口来管理这些元素，
　　使用IGraphicsContainer接口可以添加、删除和更新位于Map或Pagelayout上的元素
　　使用GroupElement对象还可以将多个元素编组为单个实体来给用户使用

　　IElement是所有图形元素和框架元素都实现的接口，通过IElement接口可以确定Element对象的Geometry属性；
　　同时IElement接口也提供了用于查找和绘制元素的方法。
　　注意：IElement 与 ILineElement 以及 ITextElement等 不是父子关系，后者没有Geometry属性

3.2.7 MapGrid 对象

　　它是布局视图中的一系列参考线和参考点，用来帮助地图使用者快速的确定地图要素的位置。
　　公里格网，MapGridBorder，MapGridLabel，MapGrid等
　　MapGrid由MapGrids来管理，一个 MapGrids可以包含多个MapGrid

　　MapGrid是一个抽象类，它的子类有MeasuredGrid，IndexGrid，MgrsGrid，Graticule和CustomOverlayGrid五种；

　　这些子类的对象由MapGridFactory对象创建。

 1         /// <summary>
 2         /// 为Pagelayout对象添加格网对象
 3         /// </summary>
 4         /// <param name="pPageLayout"></param>
 5         public void AddMeasuredGridToPageLayout(IPageLayout pPageLayout)
 6         {
 7             try
 8             {
 9                 // 获取MapFrame对象
10                 IActiveView pActiveView = pPageLayout as IActiveView;
11                 IMap pMap = pActiveView.FocusMap;
12                 // QI为IGraphicsContainer对象，来管理Pagelayout上的元素
13                 IGraphicsContainer pGraphicsContainer = pActiveView as IGraphicsContainer;
14                 // 从IGraphicsContainer对象中找到指定地图的框架元素
15                 IMapFrame pMapFrame = pGraphicsContainer.FindFrame(pMap) as IMapFrame;
16                 // 将框架元素QI为IMapGrids
17                 IMapGrids pMapGrids = pMapFrame as IMapGrids;
18 
19                 // 自此，我们得到了Pagelayout对象的 参考（参考线和参考点），接下来就开始整它
20 
21                 // 创建一个MeasureGrid对象
22                 IMeasuredGrid pMeasureGrid = new MeasuredGridClass();
23                 IMapGrid pMapGrid = pMeasureGrid as IMapGrid;
24                 pMeasureGrid.FixedOrigin = true;// 固定源
25                 pMeasureGrid.Units = pMap.MapUnits;// 设置测量格网的单位为地图的单位
26                 // 设置间隔尺寸
27                 pMeasureGrid.XIntervalSize = 100;
28                 pMeasureGrid.YIntervalSize = 100;
29                 // 设置原点位置？
30                 pMeasureGrid.XOrigin = -180;
31                 pMeasureGrid.YOrigin = -90;
32                 // 设置MeasuredGride投影属性
33                 IProjectedGrid pProGrid = pMeasureGrid as IProjectedGrid;
34                 pProGrid.SpatialReference = pMap.SpatialReference;
35                 pMapGrid.Name = "Measured Grid";
36                 // 创建一个CalibratedMapGridBorder对象(参考边界校准)并设置为pMapGrid的Border属性   
37                 ICalibratedMapGridBorder pCalibratedBorder = new CalibratedMapGridBorderClass();
38                 pCalibratedBorder.BackgroundColor = GetRgbColor(255,255,255);
39                 pCalibratedBorder.ForegroundColor = GetRgbColor(0, 0, 0);
40                 pCalibratedBorder.BorderWidth = 0.1;
41                 pCalibratedBorder.Interval = 72;
42                 pCalibratedBorder.Alternating = true;
43                 pMapGrid.Border = pCalibratedBorder as IMapGridBorder;
44 
45                 // 创建一个FormattedGridLabel对象（格式化参考标签）
46                 IFormattedGridLabel pFormattedGridLabel = new FormattedGridLabelClass();
47                 IGridLabel pGridLabel = pFormattedGridLabel as IGridLabel;
48 
49                 // 设置标签字体，需要引用类库
50                 //stdole.StdFont pFont = new stdole.StdFont();
51                 //pFont.Name = "Arial";
52                 //pFont.Size = 6;
53                 //pGridLabel.Font = pFont as stdole.IFontDisp;
54 
55                 pGridLabel.Color = GetRgbColor(0, 0, 0);
56                 pGridLabel.LabelOffset = 4;
57                 pGridLabel.set_LabelAlignment(esriGridAxisEnum.esriGridAxisLeft, false);
58                 pGridLabel.set_LabelAlignment(esriGridAxisEnum.esriGridAxisRight, false);
59 
60                 INumericFormat pNumericFormat = new NumericFormatClass();// 数字格式
61                 pNumericFormat.AlignmentOption = esriNumericAlignmentEnum.esriAlignRight;
62                 pNumericFormat.RoundingOption = esriRoundingOptionEnum.esriRoundNumberOfSignificantDigits;
63                 pNumericFormat.RoundingValue = 0;
64                 pNumericFormat.ShowPlusSign = false;
65                 pNumericFormat.ZeroPad = true;
66                 pFormattedGridLabel.Format = pNumericFormat as INumberFormat;
67 
68                 // 设置pMapGrid的LabelFormat属性
69                 pMapGrid.LabelFormat = pGridLabel;
70                 // 添加格网
71                 pMapGrids.AddMapGrid(pMapGrid);
72 
73             }
74             catch (Exception)
75             {
76 
77                 throw;
78             }
79         }

View Code

3.2.8 MapSurround对象

　　MapSurround 对象是与一个地图对象关联的用于修饰地图的辅助图形元素对象。 比例尺，比例尺文本，图例，指北针。。
　　MapSurround对象由MapSurroundFrame对象管理，所有的MapSurround对象添加在布局视图上，每一个MapSurround对象可以
　　通过IMap接口的MapSurrounds属性的索引值所获取；也可以通过IMap接口的MapSurroundCount来遍历布局视图上的所有MapSurround对象

　　所有的MapSurround对象都实现了IMapSurround接口，使用该接口的Name属性可以获得MapSurround对象的名称，
　　通过IMapSurround的FitToBound方法可以设置一个MapSurround对象的大小。
　　同时，MapSurround类也实现了IMapSurroundEvents接口，可以用来触发MapSurround相关事件，如：AfterDraw，BeforeDraw，ContensChange

　　如下代码演示如何为PageLayout添加Legend：

 1         /// <summary>
 2         /// 为PageLayout对象添加图例对象
 3         /// </summary>
 4         /// <param name="pPageLayout"></param>
 5         /// <param name="pEnvelop">图例添加的位置</param>
 6         private void AddLegendToPageLayout(IPageLayout pPageLayout, IEnvelope pEnvelop)
 7         {
 8             try
 9             {
10                 IActiveView pActiveView = pPageLayout as IActiveView;
11                 IMap pMap = pActiveView.FocusMap;
12                 IGraphicsContainer pGraphicsContainer = pActiveView as IGraphicsContainer;
13                 IMapFrame pMapFrame = pGraphicsContainer.FindFrame(pMap) as IMapFrame;
14                 UID pUID = new UID();
15                 pUID.Value = "{7A3F81E34-B9E3-11D1-8756-000F8751720}";
16                 ISymbolBackground pSymbolBackground = new SymbolBackgroundClass();
17                 IFillSymbol pFillSymbol = new SimpleFillSymbolClass();
18                 ILineSymbol pLineSymbol = new SimpleLineSymbolClass();
19                 pFillSymbol.Color = GetRgbColor(255, 255, 255);
20                 pLineSymbol.Color = GetRgbColor(255, 255, 255);
21                 pFillSymbol.Outline = pLineSymbol;
22                 pSymbolBackground.FillSymbol = pFillSymbol;
23                 IMapSurroundFrame pMapSurroundFrame = pMapFrame.CreateSurroundFrame(pUID, null);
24                 pMapSurroundFrame.Background = pSymbolBackground;
25 
26                 IElement pElement = pMapSurroundFrame as IElement;
27                 pElement.Geometry = pEnvelop;
28                 IMapSurround pMapSurround = pMapSurroundFrame.MapSurround;
29                 ILegend pLegend = pMapSurround as ILegend;
30                 pLegend.ClearItems();
31                 pLegend.Title = "图 ☆例";
32                 ITextSymbol pTextSymbol = new TextSymbolClass();
33                 pTextSymbol.Size = 10;
34                 pTextSymbol.HorizontalAlignment = esriTextHorizontalAlignment.esriTHALeft;
35                 ILegendItem pLegendItem = null;
36 
37                 for (int i = 0; i < pActiveView.FocusMap.LayerCount; i++)
38                 {
39                     ILayer pLayer = pActiveView.FocusMap.get_Layer(i);
40                     if (pLayer is IFeatureLayer)
41                     {
42                         IFeatureLayer pFlayer = pLayer as IFeatureLayer;
43                         IFeatureClass pFeatureClass = pFlayer.FeatureClass;
44                         if (pFeatureClass.FeatureType == esriFeatureType.esriFTAnnotation)
45                         {
46                             continue;
47                         }
48                         else
49                         {
50                             pLegendItem = new HorizontalBarLegendItemClass();
51                             pLegendItem.Layer = pLayer;
52                             pLegendItem.Columns = 1;
53                             pLegendItem.ShowDescriptions = false;
54                             pLegendItem.ShowHeading = false;
55                             pLegendItem.ShowLabels = true;
56                             pLegendItem.LayerNameSymbol = pTextSymbol;
57                             pLegend.AddItem(pLegendItem);
58                         }
59                     }
60                 }
61             }
62             catch (Exception)
63             {
64 
65                 throw;
66             }
67         }

View Code

程序结果如下图所示：

 

　　第三章到此结束。这章的内容是地图和地图布局，所围绕的大都是图形布局对象的操作。