ArcEngine 9.3 学习笔记(五)：地图和地图布局（PageLayout对象,Page对象,SnapGrid对象,SnapGuides对象，Element 对象，MapGrid 对象，MapSurround对象 ）

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

程序结果如下图所示：

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