正文
ArcGis 制图——地图图框整饰的插件式实现（一）C#
提示：扫一扫查出行【扫一扫了解最新限行尾号】
复制提示
如有插件定制需求或技术交流，欢迎联系QQ 975601416
写完了自己瞅了一眼都不想看，希望有需要的你能看懂。
先摆一张效果图：
下面进入主题，本篇先讲一下地图布局中的对象，正文中会对一些关键词用英文补充说明一下，这可不是作者在显摆，了解下功能的英文表述对查询帮助是很有帮助的。
直达链接：
PageLayout 页面布局视图，元素的容器
Page 版面，用于控制打印纸张
IElement接口页面元素
IFrameElement接口 框架元素，图框、外图框即此
MapFrame 地图（map）的容器
FrameElement 地图外框
MapSurroundFrame 用于管理地图周边元素（MapSurround，比例尺、指北针、图例等）
ITextElement标题等文字元素
先介绍一下主要对象类型——容器PageLayout与存放在容器中的Element元素。
PageLayout对象
ArcGis数据框有两个视图，“数据视图”（DataView）与“布局视图”（LayoutView）。制图是在“布局视图”里操作，在ArcObject里进行图框整饰就是操作“PageLayout”对象。
“PageLayout”对象实现了IGraphicsContainer接口，顾名思义，该接口提供了容器，用以存放、管理graphic elements。通过AddElement方法可以将元素（IElement）放入PageLayout，通过DeleteElement方法可以删除元素。
//PageLayout作为容器
IGraphicsContainer pGraphicsContainer = pPageLayout as IGraphicsContainer;
//IElement类型元素放入PageLayout，注意第二参zeorder固定为0（10.1，作者没有研究高版本API是否有改动）。
pGraphicsContainer.AddElement(element,);
//删除元素，注意这个element是程序运行已经存在内存中的，放入PageLayout的对象
pGraphicsContainer.DeleteElement(element);
Page对象
打印纸张的版面控制。
//单位，一般用厘米
pPageLayout.Page.Units = esriUnits.esriCentimeters;
//传入double类型值，设置页面长、宽
pPageLayout.Page.PutCustomSize(width, height);
//读取当前版面的长宽值
double width;
double height;
pPageLayout.Page.QuerySize(out width, out height);
IElement元素
在 ArcGIS 中显示在视图上的数据有两类：一类是地理要素数据，包括矢量要素数据、栅格数据、 Tin 等表面数据等，存储在 Geodatabase 或数据文件（如shapefile）中，它们是用于 GIS 分析制图的源数据；另一类是元素（Element），元素是一个地图除去要素数据外的部分，即在一幅地图中，除了地理数据外，其余的对象全部都是元素。
Element对象是一个庞大复杂的对象集合，它分为图形元素(GraphicElement)和框架元素(Frame Element)。图形元素主要包括 TextElement、 MarkerElement、 LineElement、 FillShapeElement、GroupElement 、 PictureElement 等 。 框 架 元 素 主 要 包 括 MapFrame 、MapSurroundFrame、 Table Frames 等。 这些元素都实现了IElement接口。
地图图框整饰的几个基本元素有图框（Frame）、标题（Title）、比例尺（Scale）、图例（Legend）、指北针（NorthArrow）、其他辅助要素（底部文字等）。
IFrameElement框架元素
pageLayout中用于存放地图的MapFrame实现了IMapFrame接口，该接口继承自IFrameElement接口，外框线可以使用FrameElement对象实现。
图框细分应该会有内图框、外图框。
MapFrame对象 内框
MapFrame是一个展示、存放Map图层要素（layers）的地方，直接切换到“布局视图”就可以看到它，内图框是MapFrame的边框。
内框MapFrame与PageLayout.Page的距离（上、下、侧）需要给定。图框肯定要从纸张边缘往里缩一定距离才是。
//根据与Page边的距离确定一个Envelpoe，通过它设置地图框架MapFrame的位置
IFrameElement pFrameElement = pGraphicsContainer.FindFrame(pActiveView.FocusMap);//pGraphicsContainer容器是什么？
IMapFrame pMapFrame = pFrameElement as IMapFrame;
IEnvelope pEnvelopeMapFrame = new EnvelopeClass();
pEnvelopeMapFrame.PutCoords(xmin, ymin, xmax, ymax);
IElement pElement = pFrameElement as IElement;
pElement.Geometry = pEnvelopeMapFrame;
FrameElement对象 外框
外图框只用来展示一个粗线框，其几何图形可以是MapFrame的Envelpoe外扩一定距离形成的一个Envelpoe（这里称作pEnvelpoeOuter），将FrameElement的Geometry属性设置为pEnvelpoeOuter，将FrameElement对象的边框（Boder）的线型、宽度设置一下就做出来了。
//set Outer-border frame
FrameElement frameElementOuter = new FrameElementClass();
IFrameElement pFrameElementOuter = frameElementOuter as IFrameElement;
IElementProperties3 pElementProperties = pFrameElementOuter as IElementProperties3;
pElementProperties.Name = "OuterBorder";
IEnvelope pEnvelpoeOuter = new EnvelopeClass();
pEnvelpoeOuter.PutCoords(xmin - 0.2, ymin - 0.2, xmax + 0.2, ymax + 0.2);
frameElementOuter.Geometry = pEnvelpoeOuter; //set Outer-border line style
ILineSymbol pLineSymbol = DisplayUtils.CartoLineSymbol(3.0, DisplayUtils.RGBColor(, , ));
ISymbolBorder pSymbolBorder = new SymbolBorderClass();
pSymbolBorder.LineSymbol = pLineSymbol;
IFrameProperties pFramePropertiesOuter = pFrameElementOuter as IFrameProperties;
pFramePropertiesOuter.Border = pSymbolBorder;
return frameElementOuter;
MapSurroundFrame 地图周边元素，实现了IMapSurroundFrame接口，该接口同样继承自IFrameElement接口。
比例尺、图例、指北针是MapFrame的MapSurround对象，比例尺、图例是明显的与MapFrame相关，是随图层信息动态变化的。
比例尺：采用文本型比例尺，uid.Value = "esriCarto.ScaleText"。根据MapFrame的Envelpoe与PageLayout的Page的相对位置确定其放置的。
图例：uid.Value = "esriCarto.Legend"。根据MapFrame的Envelpoe确定其位置。
指北针： uid.Value = "esriCarto.MarkerNorthArrow"。根据MapFrame的Envelpoe确定其位置。其实质是一个字符，“运行”——输入“charmap”可以打开“字符映射表”，选择ESRI North字体，选择对应的字形可以看到其16进制的CharacterIndex，使用科学计算器计算出10进制的值就可以在程序中使用了。
public IElement AddNorthArrow(IPageLayout pPageLayout, double distanceToInnerBorder, double size, int characterIndex)
{
IUID uid = new UIDClass();
uid.Value = "esriCarto.MarkerNorthArrow";
IActiveView pActiveView = pPageLayout as IActiveView;
IMapFrame pMapFrame = pGraphicsContainer.FindFrame(pActiveView.FocusMap) as IMapFrame; IMapSurroundFrame pMapSurroundFrame = pMapFrame.CreateSurroundFrame(uid as UID, null);
pMapSurroundFrame.MapSurround.Name = "NorthArrow"; IMarkerNorthArrow pMarkerNorthArrow = pMapSurroundFrame.MapSurround as IMarkerNorthArrow;
IMarkerSymbol pMarkerSymbol = pMarkerNorthArrow.MarkerSymbol;
ICharacterMarkerSymbol pCharacterMarkerSymbol = pMarkerSymbol as ICharacterMarkerSymbol;
pCharacterMarkerSymbol.CharacterIndex = characterIndex ;
pCharacterMarkerSymbol.Size = size;
pMarkerNorthArrow.MarkerSymbol = pCharacterMarkerSymbol; double xmin = pEnvelopeMapFrame.XMax - distanceToInnerBorder;
double ymin = pEnvelopeMapFrame.YMax - distanceToInnerBorder;
double xmax = pEnvelopeMapFrame.XMax - ;
double ymax = pEnvelopeMapFrame.YMax - ;
IEnvelope pEnvelope = new EnvelopeClass();
pEnvelope.PutCoords(xmin, ymin, xmax, ymax);
IFillSymbol pFillSymbol = DisplayUtils.SimpleFillSymbol(esriSimpleFillStyle.esriSFSSolid, DisplayUtils.CartoLineSymbol(, DisplayUtils.RGBColor()), DisplayUtils.RGBColor(, , ));
pMapSurroundFrame.Background = DisplayUtils.SymbolBackGRound(pFillSymbol );
IElement pNorthArrowElement = pMapSurroundFrame as IElement;
pNorthArrowElement.Geometry = pEnvelope;
return pNorthArrowElement;
}
ITextElement 文字元素，用来设置标题与其他文字元素
标题：
根据MapFrame的Envelpoe与PageLayout.Page 的宽度（width）、高度（height）确定一个位于MapFrame上方且居中的Envelpoe（这里称作TitleEnvelpoe）。创建一个TextElementClass，设置其样式，然后将其Geometry属性设置为TitleEnvelpoe就可以了。
public IElement AddTitle(IPageLayout pPageLayout, string title,string font,double size)
{
ITextElement pTextElement = new TextElementClass();
pTextElement.Text = title; pTextElement.Symbol = DisplayUtils.TextSymbol(font, size,esriTextHorizontalAlignment.esriTHACenter,esriTextVerticalAlignment.esriTVACenter); double width;
double height;
pPageLayout.Page.QuerySize(out width, out height); double xmin = ;
double ymin = pEnvelopeMapFrame.YMax;
double xmax = width;
double ymax = height;
IEnvelope pEnvelope = new EnvelopeClass();
pEnvelope.PutCoords(xmin, ymin, xmax, ymax); IElement pElement = pTextElement as IElement;
IElementProperties3 pElementProperties3 = pElement as IElementProperties3;
pElementProperties3.Name = "Title";
pElement.Geometry = pEnvelope;
return pElement;
}
底部文字：
也是是根据MapFrame的Envelpoe与PageLayout.Page的相对位置，分别确定出位于MapFrame左下角、右下角的两个Envelpoe，然后创建两个TextElementClass，设置其样式，分别塞到Envelpoe。
