ArcGis 制图——地图图框整饰的插件式实现(一)C#

时间:2021-10-20 05:28:45

如有插件定制需求或技术交流,欢迎联系QQ 975601416

写完了自己瞅了一眼都不想看,希望有需要的你能看懂。

先摆一张效果图:

ArcGis 制图——地图图框整饰的插件式实现(一)C#


下面进入主题,本篇先讲一下地图布局中的对象,正文中会对一些关键词用英文补充说明一下,这可不是作者在显摆,了解下功能的英文表述对查询帮助是很有帮助的。

直达链接:

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进制的值就可以在程序中使用了。
ArcGis 制图——地图图框整饰的插件式实现(一)C#

   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。