简介基于C#与ArcGIS Engine的地图整饰与输出示例工程面向GIS开发人员和地理信息相关专业学生用于掌握地图出版级的整饰要素编程实现。压缩包共包含140个文件约2.45MB主要类型包括C#源码、编译生成的exe程序、resx界面资源文件、shapefile地图数据及VS工程配置等轻量便携可直接运行或导入开发环境修改。目前已有429人学习下载。工程覆盖指北针按地图旋转动态调整样式、图例排版定制、线性/曲线比例尺设置、直角/极坐标/地理坐标三种格网创建、制图模板复用以及打印输出时的纸张尺寸、分辨率、打印范围控制并支持导出PDF、JPEG、SVG等格式。通过阅读和运行该示例开发者可系统梳理ArcGIS Engine在制图整饰方面的常用接口与事件交互方式快速搭建设计自己的地图输出模块同时规避常见的坐标、符号和渲染配置问题。1. 地图整饰用 C# 写比在 ArcMap 里手点快三倍干过地图出图的人都懂最耗时间的不是数据配图而是整饰——指北针、比例尺、图例、图廓、经纬网每张图都得摆一遍。尤其是用 ArcGIS Engine 做二次开发时如果仍然靠 ArcMap 手工整饰再导出一个项目几十张图能磨掉一整天。这份 C# 地图整饰与输出资源解决的就是把整饰要素全部代码化指北针用 MapSurround 动态生成、比例尺按数据框比例尺自动换算、图例按图层顺序重排最后批量导出。新手能照着把第一张带整饰的地图跑出来熟手能直接拿去改参数接进自己的出图模块。适合做 GIS 二次开发、测绘内业出图、以及被批量出图逼疯的 C# 工程师。2. 地图整饰的对象模型搞懂 MapSurround 再动手2.1 为什么整饰不能靠贴图片很多第一次做整饰的人会把指北针做成一张 PNG 硬怼到地图上比例尺也是一张静态图。这在单张图里看着没问题一旦地图范围变了、比例尺变了图片不会跟着变出图就废了。ArcGIS Engine 里有一套完整的整饰对象体系核心就是 MapSurround——它不是图片而是挂在地图边框上的动态对象跟着 View 的缩放、旋转自动更新。MapSurround 有几个关键类型指北针类MarkerNorth、MarkerNorthStar、Compass、比例尺类SingleDivisionScaleBar、AlternatingScaleBar、HollowScaleBar 等、图例Legend、经纬网Graticule。它们都实现 IMapSurround 接口再被塞进 IMapSurroundFrame 里。Frame 管位置和大小MapSurround 管样式和数据。理解这个层级是第一步一个完整的整饰要素 Frame位置 MapSurround内容 Symbol样式。三个缺一不可而且全部代码可控。// 创建一个指北针并挂到地图上 IMapSurroundFrame northFrame new MapSurroundFrameClass(); IMapSurround northSurround new MarkerNorthClass(); // 先创建指北针对象 northFrame.MapSurround northSurround; // Frame 挂载指北针 northFrame.Map map; // Frame 必须知道属于哪个地图说明MarkerNorthClass 是内置指北针样式之一直接 new 出来就是成品。Frame 的 Map 属性必须赋值否则整饰要素不会出现在输出里。这一步经常有人漏漏了的结果就是代码跑完图上一个指北针都没有。2.2 IMapSurroundFrame 与 IMapSurround两个接口管住所有要素IMapSurroundFrame 继承自 IElement意味着它同时具备图形元素的能力——可以设置 Geometry位置边界、激活状态、是否可见。IMapSurround 是内容接口负责样式和行为。这两者合在一起才能完整控制一个整饰要素。实际操作中Frame 的 Geometry 通常有两种指定方式一是手动指定一个矩形 IEnvelope精确控制整饰要素在纸面上的位置二是让它默认放在地图边框外侧由 Engine 自动排布。后一种虽然省事但出图时位置不可控不同尺寸的图纸差异很大我不推荐在批量出图场景里用。// 手动控制指北针在页面上的位置 IEnvelope northEnvelope new EnvelopeClass(); northEnvelope.XMin pageWidth - 2.5; // 页面坐标单位是页单位通常为厘米 northEnvelope.YMin pageHeight - 2.5; northEnvelope.XMax pageWidth - 1.2; northEnvelope.YMax pageHeight - 1.2; IFrameElement frameElement northFrame as IFrameElement; frameElement.Geometry northEnvelope;说明这里的 pageWidth 和 pageHeight 要从 IPageLayout 里读取而不是拿地图的 Extent 算。页坐标和地理坐标是两套系统混用会导致整饰要素跑到奇怪的位置。页单位默认取决于打印机设置国内出图一般用厘米建议在初始化页面时显式指定。2.3 整饰前的准备图层过滤与地图容器初始化整饰要素里图例最依赖图层状态。图例默认会把数据框里所有图层全部列出来包括那些只是辅助显示、不该出现在正式图上的图层比如临时标注层、辅助网格层。所以在生成图例之前要先把不需要的图层过滤掉。常见做法是维护一个 VisibleLayers 列表把要出图的图层 ID 放进去遍历 IMap 的 Layers 属性时逐一比对。这比每次临时判断 Visible 属性要稳因为 Visible 属性可能被其他业务逻辑改掉。// 图例只显示指定图层 ILegend legend new LegendClass(); legend.AutoVisibility false; // 关闭自动可见性 IMapSurroundFrame legendFrame new MapSurroundFrameClass(); legendFrame.MapSurround legend; legendFrame.Map map; IMap pMap map as IMap; for (int i 0; i pMap.LayerCount; i) { ILayer layer pMap.get_Layer(i); if (allowedLayerNames.Contains(layer.Name)) { legend.AddItem(layer, true); // 第二个参数控制是否显示该图层 } }说明legend.AddItem 的第二个参数是 visible传 true 才会在图上显示。AutoVisibility 如果保持默认 true图例会跟随图层的 Visible 状态自动增减这在批量出图时是灾难——某张图临时隐藏了图层图例就少一项。设成 false 后图例完全由代码控制稳定。3. 把指北针、比例尺、图例写进代码三类要素的完整实现3.1 指北针Compass 与 MarkerNorth 怎么选指北针在 ArcGIS Engine 里不是一个类而是一族类。CompassClass、MarkerNorthClass、MarkerNorthStarClass 是三个最常用的。区别在于Compass 是罗盘样式指针带刻度盘适合大比例尺正式图MarkerNorth 是简笔箭头干净利落适合小比例尺示意图MarkerNorthStar 是带星星的箭头偏装饰性。从实际出图效果来看测绘类项目偏爱 Compass因为它有刻度能体现方位精度规划类项目多用 MarkerNorth因为图面简洁。这个选择没有绝对标准但代码里切换成本极低建议做一个配置项而不是写死。public IMapSurround CreateNorthArrow(string styleType) { IMapSurround north null; switch (styleType) { case compass: north new CompassClass(); break; case north: north new MarkerNorthClass(); break; default: north new MarkerNorthStarClass(); break; } // 调整指北针大小 IMapSurroundFrame northFrame new MapSurroundFrameClass(); northFrame.MapSurround north; northFrame.Map map; IElementProperties props north as IElementProperties; if (props ! null) { props.Visible true; } return north; }说明IMapSurround 统一了三种指北针的创建方式业务层只需要传字符串即可切换。如果发现指北针在图面上太小或太大不要去改 Symbol 的 Size而是去调 Frame 的 Geometry——因为指北针绘制的实际尺寸由 Frame 决定MapSurround 只是提供图形内容。这个关系很多人搞反改半天 Symbol 没反应。3.2 比例尺从单位换算到 ScaleBar 尺寸比例尺是所有整饰要素里最容易出错的因为涉及地图单位、页面单位、比例尺显示单位三者换算。ArcGIS Engine 的 ScaleBar 会自动跟着数据框比例尺走但它默认的判断逻辑依赖数据框的 MapScale 属性。如果你的数据框没有正确设置 MapScale比例尺永远是错的。比例尺类型选择也有讲究SingleDivisionScaleBar 只显示一个主刻度段适合短比例尺AlternatingScaleBar 黑白交替分段适合长比例尺HollowScaleBar 是空心分段。国内出图最常用的是 AlternatingScaleBar因为黑白交替在打印时最清晰。// 创建比例尺并绑定数据框 IScaleBar scaleBar new AlternatingScaleBarClass(); scaleBar.Map map; // 告诉比例尺当前地图 scaleBar.MapScale map.MapScale; // 显式传递比例尺数值 scaleBar.ResizeHint esriScaleBarResizeHint.esriScaleBarResizeAdjustWidth; scaleBar.LabelFormat.Format 1:{0}; scaleBar.LabelPosition esriScaleBarLabelPosition.esriScaleBarAfterBar; scaleBar.Divisions 3; // 主刻度段数 scaleBar.DivisionsBeforeFirstSubdivision 1; scaleBar.Subdivisions 2; // 每个主刻度内的细分段数 IMapSurroundFrame barFrame new MapSurroundFrameClass(); barFrame.MapSurround scaleBar; barFrame.Map map;说明ResizeHint 有三个取值Auto 让比例尺随 Frame 自动伸缩AdjustWidth 只调整宽度不调整分段数AdjustDivision 调整分段数保持宽度。批量出图时建议用 AdjustWidth——这样比例尺的分段结构恒定只是宽度变化视觉上最统一。LabelFormat 是比例尺数字的格式化模板“1:{0}”表示只显示比例尺分母比如 1:5000。如果你的图是经纬度坐标系MapScale 算出来的是基于赤道附近的近似值这时候比例尺显示会偏大需要手工修正这个坑后面专门讲。3.3 图例ILegendFormat 控制字体与行列图例的坑不在生成在排版。默认生成的图例是纵向单列要素一多就变成一条巨长的竖条严重挤压地图主体。ILegendFormat 可以控制图例的列数、字体、间距、标题其中 ColumnCount 是最常用的——设置成 2 或 3图例立刻从竖条变方块。// 设置图例的排版格式 ILegendFormat legendFormat new LegendFormatClass(); legendFormat.ColumnCount 2; // 图例分两列 legendFormat.Gap 12; // 图例项之间的间距单位是点 legendFormat.ItemHeight 20; legendFormat.Title 图例; legendFormat.TitleSymbol.Size 14; ILegend pLegend legendFrame.MapSurround as ILegend; pLegend.Format legendFormat;说明Gap 是图例项之间的垂直间距单位是磅point不是像素也不是厘米。如果图例项之间有重叠或挤得太紧优先调 Gap 而不是动 Frame 的高度。ItemHeight 控制每个图例项的高度当图层符号比较大时需要同步加大否则符号会被裁切。还有一个常见问题图例中出现了重复的图层名。这通常是因为数据框里存在多个同名图层而 legend.AddItem 没有做去重。避坑的办法是生成图例前用 layer.Name 和 layer.Visible 双重条件过滤只取唯一且可见的图层。4. 地图整饰避坑输出前最容易翻车的四个细节4.1 坑指北针跑到了图廓外面现象指北针创建成功代码没报错但导出的图上指北针在纸张边缘被截断或者干脆跑出图面。原因Frame 的 Geometry 是用页坐标指定的但页坐标的原点不在页面左上角而在页面中心。很多人拿页面宽度直接算坐标结果 XMin 和 XMax 超出了实际页面的有效范围。解决先把 IActiveView 转成 IPageLayout拿到页面实际的宽度和高度再基于页面中心点计算四个角。IPageLayout pageLayout activeView as IPageLayout; double w pageLayout.Page.Width; double h pageLayout.Page.Height; // 坐标原点在页面中心右下角是 (w/2, -h/2) IEnvelope env new EnvelopeClass(); env.XMin w / 2 - 2.0; // 距右边 2 厘米 env.YMin -h / 2 1.5; // 距下边 1.5 厘米 env.XMax w / 2 - 0.5; env.YMax -h / 2 3.0; frameElement.Geometry env;说明记住一个核心规律——页面坐标原点永远在页面中心。左上角是负 x、正 y右下角是正 x、负 y。如果还按数学坐标系那套“左上角为原点”的思路写指北针永远定位不对。4.2 坑比例尺数字对不上现象图上比例尺标注是 1:5000但用测量工具量实际距离对不上或者比例尺的数值与实际出图范围严重不符。原因两个常见原因。一是数据框的 MapScale 属性没设ScaleBar 拿到了默认值二是数据框是地理坐标系经纬度MapScale 本身就是一个估算值并不准确。解决如果数据框是投影坐标系确认在创建比例尺前给 map.MapScale 赋值。如果数据框是地理坐标系不要依赖 ScaleBar 自动换算而是人工计算一个比例尺因子。// 经纬度数据框下的比例尺修正 double trueScale map.MapScale; double latitude map.SpatialReference.Origin.Y; // 取数据框中心纬度 double correctionFactor Math.Cos(latitude * Math.PI / 180.0); scaleBar.MapScale trueScale * correctionFactor;说明在纬度为 0 的地方赤道修正因子是 1.0不需要修正纬度越高修正因子越小。这个算法不精确但对出图场景足够用。如果是高精度测绘成果图图框和数据框都要用投影坐标系别用经纬度直接出图。4.3 坑导出 PNG 白边或黑边现象代码调用 ExportActiveView 导出 PNG生成的图片四周有一圈白边或黑边在系统里嵌入时非常难看。原因导出时设置的像素尺寸和页面尺寸比例不一致导致输出图片被强制拉伸或者背景色没设置成白色默认透明背景在部分看图软件里显示成黑色。解决导出前手动指定背景色并把输出像素比例锁定到页面的宽高比。// 导出前锁定页面宽高比 IExport export new ExportPNGClass(); export.ExportFileName outputPath; export.Resolution 300; IActiveView activeView map as IActiveView; IRectangle pageRect activeView.OutputRect; // 页面矩形单位是页单位 int pixelWidth (int)(pageRect.Width * export.Resolution / 2.54); int pixelHeight (int)(pageRect.Height * export.Resolution / 2.54); export.PixelBounds new TagRECT { left 0, top 0, right pixelWidth, bottom pixelHeight };说明export.Resolution 的单位是 DPI这里除以 2.54 是为了从厘米换算到英寸再乘 DPI得到实际像素数。如果直接指定 PixelBounds 的宽高而不和页面宽高比一致导出的图就会被拉伸比例尺和指北针全部变形。4.4 坑整饰要素不更新现象第一次创建指北针、比例尺后显示正常但改了地图范围再导出指北针位置和比例尺数值还是旧的。原因MapSurround 不是实时刷新的它缓存了上一次的计算结果。改地图范围和比例尺后需要手动触发刷新。解决在导出前统一调用一次刷新逻辑让所有 MapSurround 重新绑定数据。// 强制刷新所有整饰要素 for (int i 0; i map.MapSurroundCount; i) { IMapSurround surround map.get_MapSurround(i); if (surround is IScaleBar) { IScaleBar sb surround as IScaleBar; sb.MapScale map.MapScale; // 重设比例尺数值 } surround.Refresh(); } activeView.Refresh();说明IMapSurround 本身没有 Refresh 方法但大部分具体类实现了 IMapSurround 的 Refresh 行为。这段代码的核心逻辑是先重置比例尺数值再做一次整体刷新。实际项目里这个刷新函数放在导出函数的最前面每次导出强制走一遍。4.5 坑不同 ArcGIS Engine 版本接口差异现象同样的代码在 ArcGIS Engine 10.2 上编译通过换到 10.7 就报找不到类或命名空间或者反过来新版本能跑老版本编译报错。原因部分整饰类库在高版本中被标记为废弃比如某些比例尺类的构造函数调整过另外 ArcGIS Engine 10.2 后的 Runtime 不再内置部分 UI 组件需要单独分发。解决精简运行时依赖创建整饰要素时优先使用 IMapSurround 接口而不是具体的实现类打包时勾选对应的扩展模块。开发阶段就要定死目标版本别写一套代码指望全版本通用。// 用接口声明代替具体类降低版本耦合 IMapSurround CreateScaleBarByVersion() { // 通过 Type.GetTypeFromProgID 创建避免硬编码类名 Type type Type.GetTypeFromProgID(esriCarto.AlternatingScaleBar); return (IMapSurround)Activator.CreateInstance(type); }说明用 ProgID 创建整饰对象的好处是版本升级后只要修改配置文件的 ProgID 即可不用改代码。代价是少了编译期类型检查控件属性设置出错只能运行时暴露。适合在插件体系中用普通项目还是直接 new 具体类更稳。5. 批量出图的进阶参数化配置与多图遍历导出5.1 把整饰参数做成配置类单张图整饰跑通之后真正的效率提升来自批量。我的习惯是写一个 MapLayoutConfig 类把指北针样式、比例尺类型、图例列数、边距全部收进一个对象每次出图只需要 new 一个配置实例赋值后传给导出函数。public class MapLayoutConfig { public string NorthStyle { get; set; } // compass / north / northstar public string ScaleBarStyle { get; set; } // alternating / single / hollow public bool ShowLegend { get; set; } public int LegendColumns { get; set; } public double MarginRight { get; set; } // 整饰要素距页面右边距离 public double MarginBottom { get; set; } public int DPI { get; set; } 300; // 导出分辨率 }说明这个类不需要任何 ArcGIS Engine 引用是纯业务层对象。好处是出图逻辑可以单元测试而且在多线程批量出图时每个线程持有独立的配置实例不会互相污染。5.2 遍历地图文档批量导出实际项目中地图文档往往不止一个。批量导出的模式一般是遍历指定文件夹下的所有 .mxd逐个打开、应用配置、导出。关键是导出的文件名规则要统一推荐“原图名_比例尺_日期”的格式。public void BatchExportMaps(string mxdFolder, string outputFolder, MapLayoutConfig config) { string[] mxdFiles Directory.GetFiles(mxdFolder, *.mxd); foreach (string mxdPath in mxdFiles) { IMapDocument mapDoc new MapDocumentClass(); mapDoc.Open(mxdPath, ); // 取第一个数据框实际项目建议循环处理多个数据框 IMap map mapDoc.get_Map(0); IActiveView activeView map as IActiveView; activeView.Refresh(); // 套用整饰配置 ApplyMapLayout(map, config); // 生成输出路径 string fileName Path.GetFileNameWithoutExtension(mxdPath); string outputPath Path.Combine(outputFolder, ${fileName}_{Convert.ToInt32(map.MapScale)}.png); ExportMapToPng(activeView, outputPath, config.DPI); mapDoc.Close(); } }说明批量导出最忌讳的就是单个地图文档打开后不关闭导致内存暴涨。IMapDocument 一定要在每次循环末尾 Close最好再用 try/finally 包一层。另外批量场景下如果有一张图抛异常不要中断整个循环而是记下错误继续下一张最后统一打印失败清单。我之前做一个区县年鉴项目24 个乡镇图斑图手工整饰每张至少半小时用这套代码批量跑完加上调样式的时间整个出图流程缩短到一上午。从那以后我每次做批量出图都强制走一遍“先跑单张确认样式 → 再跑全量验证稳定性 → 最后才交图”的三步流程再也没在交付前夜翻过车。希望帮到你。本文还有配套的精品资源点击获取