《ArcGIS Engine C#实例开发教程》各个模块的集合.doc

《《ArcGIS Engine C#实例开发教程》各个模块的集合.doc》由会员分享，可在线阅读，更多相关《《ArcGIS Engine C#实例开发教程》各个模块的集合.doc（77页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、在上一讲中，我们完成了 MapControl 和 PageLayoutControl 两种视图的同步工作，本讲我们将完成状态栏信息的添加与实现。 应用程序的状态栏一般用来显示程序的当前状态，当前所使用的工具。 GIS 应用程序一般也在状态栏显示当前光标的坐标、比例尺等信息。 学习完本讲内容，您将学会状态栏编程的基本方法，并且能够在我们的程序的状态栏中添加且显示以下信息： 当前所用工具信息 当前比例尺 当前坐标 1、 添加状态栏项目 在设计视图中，点击窗体中的状态栏，在其属性面板中找到“ Items ”项，单击其右边的按钮，在下拉框中选择“ StatusLabel ”，单击“添加按钮”，依次添加

2、四个 StatusLabel ，依次修改属性参数如下表所示： 序号 Name 属性 Text 属性 Spring 属性 说明 1 MessageLabel 就绪 False 当前所用工具信息 2 Blank True 占位 3 ScaleLabel 比例尺 False 当前比例尺 4 CoordinateLabel 当前坐标 False 当前坐标 设置好之后如下图所示： Tips ： 我们设计出的状态栏最终如下所示： 就绪 （ Blank ） 比例尺 当前坐标 Spring 属性表示可以按状态栏剩余空间自动伸缩。所以加入 Blank 项目，只是为了占个位子，以达到 ScaleLabel 和 C

3、oordinateLabel 项目右对齐而 MessageLabel 项目左对齐的目的。 2、 显示当前所用工具信息 首先添加 axToolbarControl1 的 OnMouseMove 事件 ( 相信大家看了以上的教程，已经知道怎么添加事件了吧，还不知道的建议再温习下前几讲的内容 ) 。在其事件响应函数代码如下： private void axToolbarControl1_OnMouseMove(object sender, IToolbarControlEvents_OnMouseMoveEvent e) / 取得鼠标所在工具的索引号 int index = axToolbarCon

4、trol1.HitTest(e.x, e.y, false); if (index != -1) / 取得鼠标所在工具的 ToolbarItem IToolbarItem toolbarItem = axToolbarControl1.GetItem(index); / 设置状态栏信息 MessageLabel.Text = toolbarItem mand.Message; else MessageLabel.Text = 就绪 ; 3、 显示当前比例尺 添加 axMapControl1 的 OnMouseMove 事件，其代码如下： private void axMapControl1_O

5、nMouseMove(object sender, IMapControlEvents2_OnMouseMoveEvent e) / 显示当前比例尺 ScaleLabel.Text = 比例尺 1: + (long)this.axMapControl1.MapScale).ToString(); 4、 显示当前坐标 显示当前坐标也是 axMapControl1 的 OnMouseMove 事件中响应，故只要在 axMapControl1_OnMouseMove 函数中添加如下代码即可： / 显示当前坐标 CoordinateLabel.Text = 当前坐标 X = + e.mapX.ToSt

6、ring() + Y = + e.mapY.ToString() + + this.axMapControl1.MapUnits; 按 F5 编译运行，可以看到，我们的程序已经能够正常工作了。但是细心的你可能会发现，当前坐标的后面的坐标单位为“ esriUnknownUnits ”或“ esriMeters ”之类，即系统在正常单位的前面加上了“ esri ”，追求完美的我们自然看得不舒服。那就进行简单的替换吧。 首先定义个全局坐标单位变量 sMapUnits ，如下所示： private string sMapUnits; 再 Form1_Load 函数中进行初始化： sMapUnits =

7、 Unknown; 添加 axMapControl1 控件的 OnMapReplaced 事件，在事件响应函数中进行坐标单位替换，代码如下： private void axMapControl1_OnMapReplaced(object sender, IMapControlEvents2_OnMapReplacedEvent e) esriUnits mapUnits = axMapControl1.MapUnits; switch (mapUnits) case esriUnits.esriCentimeters: sMapUnits = Centimeters; break; case

8、esriUnits.esriDecimalDegrees: sMapUnits = Decimal Degrees; break; case esriUnits.esriDecimeters: sMapUnits = Decimeters; break; case esriUnits.esriFeet: sMapUnits = Feet; break; case esriUnits.esriInches: sMapUnits = Inches; break; case esriUnits.esriKilometers: sMapUnits = Kilometers; break; case e

9、sriUnits.esriMeters: sMapUnits = Meters; break; case esriUnits.esriMiles: sMapUnits = Miles; break; case esriUnits.esriMillimeters: sMapUnits = Millimeters; break; case esriUnits.esriNauticalMiles: sMapUnits = NauticalMiles; break; case esriUnits.esriPoints: sMapUnits = Points; break; case esriUnits

10、.esriUnknownUnits: sMapUnits = Unknown; break; case esriUnits.esriYards: sMapUnits = Yards; break; 5、 编译运行 按 F5 编译运行程序。如果你足够细心的话，相信你已经成功了！ 在本讲中，介绍中 StatusStrip 控件的基本使用方法和 AE 中当所用工具信息、当前比例尺和当前坐标的显示调用方法。 在上一讲中，我们实现了状态栏的相关信息显示，在这一讲中我们将要实现鹰眼功能。 所谓的鹰眼，就是一个缩略地图，上面有一个矩形框，矩形框区域就是当前显示的地图区域，拖动矩形框可以改变当前地图显示的位置

11、，改变矩形框的大小，可以改变当前地图的显示区域大小，从起到导航的作用。鹰眼是地图浏览中常用的功能之一。 关于鹰眼的实现方式，最常用的是用一个 MapControl 控件显示地图全图，并在上面画一个红色矩形框表示当前地图的显示范围，并实现鹰眼 MapControl 与主窗体的 MapControl 互动。本讲最终效果如下所示： 图 1 鹰眼效果 1 、添加鹰眼控件 由于本教程在第一讲中没有预先考虑到鹰眼所放的位置，故我们要先稍微调整一下程序框架，并添加一个 MapControl 用于显示鹰眼。 在本教程中，我们将鹰眼放在图层控件的下方，调整方法如下： （ 1 ）在设计视图中，选择 tabCont

12、rol1 控件，即放图层和属性的那个容器，将其 Dock 属性设为 None ，并用鼠标拖拽将其缩小。把工具箱中的 SplitContainer 控件拖到窗体的左窗格，即放在 tabControl1 控件的旁边。并将其 Orientation 属性设置为 Horizontal 。 （ 2 ）选中 tabControl1 控件，按 Ctrl+X 剪切，再选中刚才粘贴到 SplitContainer2 的 Panel1 中，如图 2 所示。操作完成后效果如图 3 所示。 图 2 图 3 （ 3 ）再选中 SplitContainer2 控件（如果不好选中，直接以属性面板中选择 SplitConta

13、iner2 ），将其 Dock 属性设置为 Fill 。再选中 tabControl1 ，将其 Dock 属性也设置为 Fill 。 （ 4 ）从工具箱中选择 MapControl 控件并拖到 SplitContainer2 的 Panel2 ，作为鹰眼控件。最终效果如图 4 所示。 图 4 2 、鹰眼的实现 （ 1 ）载入地图到鹰眼控件 当地图载入到主 Map 控件时，同时也载入到鹰眼控件，在 axMapControl1_OnMapReplaced 事件响应函数（此函数上一讲中已经添加了）中添加如下代码： private void axMapControl1_OnMapReplaced(ob

14、ject sender, IMapControlEvents2_OnMapReplacedEvent e) / 前面代码省略 / 当主地图显示控件的地图更换时，鹰眼中的地图也跟随更换 this.axMapControl2.Map = new MapClass(); / 添加主地图控件中的所有图层到鹰眼控件中 for (int i = 1; i = this.axMapControl1.LayerCount; i+) this.axMapControl2.AddLayer(this.axMapControl1.get_Layer(this.axMapControl1.LayerCount - i

15、); / 设置 MapControl 显示范围至数据的全局范围 this.axMapControl2.Extent = this.axMapControl1.FullExtent; / 刷新鹰眼控件地图 this.axMapControl2.Refresh(); （ 2 ）绘制鹰眼矩形框 为鹰眼控件 MapControl1 添加 OnExtentUpdated 事件，此事件是在主 Map 控件的显示范围改变时响应，从而相应更新鹰眼控件中的矩形框。其响应函数代码如下： private void axMapControl1_OnExtentUpdated(object sender, IMapCo

16、ntrolEvents2_OnExtentUpdatedEvent e) / 得到新范围 IEnvelope pEnv = (IEnvelope)e.newEnvelope; IGraphicsContainer pGra = axMapControl2.Map as IGraphicsContainer; IActiveView pAv = pGra as IActiveView; / 在绘制前，清除 axMapControl2 中的任何图形元素 pGra.DeleteAllElements(); IRectangleElement pRectangleEle = new Rectangle

17、ElementClass(); IElement pEle = pRectangleEle as IElement; pEle.Geometry = pEnv; / 设置鹰眼图中的红线框 IRgbColor pColor = new RgbColorClass(); pColor.Red = 255; pColor.Green = 0; pColor.Blue = 0; pColor.Transparency = 255; / 产生一个线符号对象 ILineSymbol pOutline = new SimpleLineSymbolClass(); pOutline.Width = 2; pO

18、utline.Color = pColor; / 设置颜色属性 pColor = new RgbColorClass(); pColor.Red = 255; pColor.Green = 0; pColor.Blue = 0; pColor.Transparency = 0; / 设置填充符号的属性 IFillSymbol pFillSymbol = new SimpleFillSymbolClass(); pFillSymbol.Color = pColor; pFillSymbol.Outline = pOutline; IFillShapeElement pFillShapeEle =

19、 pEle as IFillShapeElement; pFillShapeEle.Symbol = pFillSymbol; pGra.AddElement(IElement)pFillShapeEle, 0); / 刷新 pAv.PartialRefresh(esriViewDrawPhase.esriViewGraphics, null, null); （ 3 ）鹰眼与主 Map 控件互动 为鹰眼控件 MapControl2 添加 OnMouseDown 事件，代码如下： private void axMapControl2_OnMouseDown(object sender, IMap

20、ControlEvents2_OnMouseDownEvent e) if (this.axMapControl2.Map.LayerCount != 0) / 按下鼠标左键移动矩形框 if (e.button = 1) IPoint pPoint = new PointClass(); pPoint.PutCoords(e.mapX, e.mapY); IEnvelope pEnvelope = this.axMapControl1.Extent; pEnvelope.CenterAt(pPoint); this.axMapControl1.Extent = pEnvelope; this.

21、axMapControl1.ActiveView.PartialRefresh(esriViewDrawPhase.esriViewGeography, null, null); / 按下鼠标右键绘制矩形框 else if (e.button = 2) IEnvelope pEnvelop = this.axMapControl2.TrackRectangle(); this.axMapControl1.Extent = pEnvelop; this.axMapControl1.ActiveView.PartialRefresh(esriViewDrawPhase.esriViewGeogra

22、phy, null, null); 为鹰眼控件 MapControl2 添加 OnMouseMove 事件，主要实现按下鼠标左键的时候移动矩形框，同时也改变主的图控件的显示范围。代码如下： private void axMapControl2_OnMouseMove(object sender, IMapControlEvents2_OnMouseMoveEvent e) / 如果不是左键按下就直接返回 if (e.button != 1) return; IPoint pPoint = new PointClass(); pPoint.PutCoords(e.mapX, e.mapY); t

23、his.axMapControl1.CenterAt(pPoint); this.axMapControl1.ActiveView.PartialRefresh(esriViewDrawPhase.esriViewGeography, null, null); 1、 编译运行 按 F5 编译运行程序。 期待的鹰眼功能你已经实现了，按下左键在鹰眼窗口中移动，或者按下右键在鹰眼窗口中画一个矩形，主地图窗口的显示范围都会跟着变化。主地图窗口中的地图经放大缩小等操作后，鹰眼窗口的矩形框大小也会随着改变。 在上一讲中，我们完成了鹰眼功能，在这一讲中，大家将实现TOCControl控件和主地图控件的右键菜

24、单。在AE开发中，右键菜单有两种实现方式，一是使用VS2005自带的ContextMenuStrip控件，二是用AE封装的IToolbarMenu接口。相比较而言，后者更为简单实用，本文采用后者的实现方法。1、创建右键菜单在Form1类里面添加如下变量的定义：/TOCControl控件变量 private ITOCControl2 m_tocControl = null;/TOCControl中Map菜单private IToolbarMenu m_menuMap = null;/TOCControl中图层菜单private IToolbarMenu m_menuLayer = null;在F

25、orm1_Load函数进行初始化，即菜单的创建：m_menuMap = new ToolbarMenuClass();m_menuLayer = new ToolbarMenuClass();2、添加菜单项第1步中创建的菜单可认为是菜单容器，里面什么都没有，具体的命令或工具作为菜单项添加到菜单容器才能工作。一般情况下，启动程序就要完成菜单项的添加，故此工作在Form1_Load函数完成。当然，添加菜单项之前，必须实现相应命令或工具。这里的命令或工具可以AE内置的也可以是自定义的。AE内置了许多可以直接调用的常用命令和工具，如ControlsAddDataCommandClass，在ESRI.A

26、rcGIS.Controls命名空间中，大家可以对象浏览器中查看。当然，这里也可以直接调用AE内置的菜单，如ControlsFeatureSelectionMenu。另外，本讲也实现三自定义命令，以做示范。它们分别为图层可视控制命令（用于控制图层显示与否）、移除图层和放大到整个图层命令。实现方法也很简单，就是右击3sdnMap项目，选择“添加|类”，选择C#普通的类模板，用以下代码覆盖系统自己生成的所有代码。图层可视控制类LayerVisibility代码：using ESRI.ArcGIS.ADF.BaseClasses; using ESRI.ArcGIS.Controls;using E

27、SRI.ArcGIS.Carto;using ESRI.ArcGIS.SystemUI;namespace _sdnMap/ / 图层可视控制/ public sealed class LayerVisibility : BaseCommand, ICommandSubType private IHookHelper m_hookHelper = new HookHelperClass();private long m_subType;public LayerVisibility()public override void OnClick()for (int i=0; i = m_hookHe

28、lper.FocusMap.LayerCount - 1; i+)if (m_subType = 1) m_hookHelper.FocusMap.get_Layer(i).Visible = true;if (m_subType = 2) m_hookHelper.FocusMap.get_Layer(i).Visible = false;m_hookHelper.ActiveView.PartialRefresh(esriViewDrawPhase.esriViewGeography,null,null);public override void OnCreate(object hook)

29、m_hookHelper.Hook = hook;public int GetCount()return 2;public void SetSubType(int SubType)m_subType = SubType;public override string Captiongetif (m_subType = 1) return Turn All Layers On;else return Turn All Layers Off;public override bool Enabledgetbool enabled = false; int i;if (m_subType = 1) fo

30、r (i=0;i=m_hookHelper.FocusMap.LayerCount - 1;i+)if (m_hookHelper.ActiveView.FocusMap.get_Layer(i).Visible = false)enabled = true;break;else for (i=0;i=m_hookHelper.FocusMap.LayerCount - 1;i+)if (m_hookHelper.ActiveView.FocusMap.get_Layer(i).Visible = true)enabled = true;break;return enabled; 移除图层类R

31、emoveLayer代码：using ESRI.ArcGIS.ADF.BaseClasses; using ESRI.ArcGIS.Carto;using ESRI.ArcGIS.Controls;namespace _sdnMap/ / 删除图层/ public sealed class RemoveLayer : BaseCommandprivate IMapControl3 m_mapControl;public RemoveLayer()base.m_caption = Remove Layer;public override void OnClick()ILayer layer =

32、(ILayer)m_mapControl.CustomProperty;m_mapControl.Map.DeleteLayer(layer);public override void OnCreate(object hook)m_mapControl = (IMapControl3)hook; 放大至整个图层类ZoomToLayer：using ESRI.ArcGIS.ADF.BaseClasses; using ESRI.ArcGIS.Carto;using ESRI.ArcGIS.Controls;namespace _sdnMap/ / 放大至整个图层/ public sealed c

33、lass ZoomToLayer : BaseCommandprivate IMapControl3 m_mapControl;public ZoomToLayer()base.m_caption = Zoom To Layer;public override void OnClick()ILayer layer = (ILayer)m_mapControl.CustomProperty;m_mapControl.Extent = layer.AreaOfInterest;public override void OnCreate(object hook)m_mapControl = (IMa

34、pControl3)hook;以上三个工具或命令的实现代码比较简单，在此不过多的分析，请读者自行理解。下面在Form1_Load函数中进行菜单项的添加，代码如下：/添加自定义菜单项到TOCCOntrol的Map菜单中 /打开文档菜单m_menuMap.AddItem(new OpenNewMapDocument(m_controlsSynchronizer), -1, 0, false, esriCommandStyles.esriCommandStyleIconAndText);/添加数据菜单m_menuMap.AddItem(new ControlsAddDataCommandClass(

35、), -1, 1, false, esriCommandStyles.esriCommandStyleIconAndText);/打开全部图层菜单m_menuMap.AddItem(new LayerVisibility(), 1, 2, false, esriCommandStyles.esriCommandStyleTextOnly);/关闭全部图层菜单m_menuMap.AddItem(new LayerVisibility(), 2, 3, false, esriCommandStyles.esriCommandStyleTextOnly);/以二级菜单的形式添加内置的“选择”菜单m_

36、menuMap.AddSubMenu(esriControls.ControlsFeatureSelectionMenu, 4, true);/以二级菜单的形式添加内置的“地图浏览”菜单m_menuMap.AddSubMenu(esriControls.ControlsMapViewMenu,5, true);/添加自定义菜单项到TOCCOntrol的图层菜单中m_menuLayer = new ToolbarMenuClass();/添加“移除图层”菜单项m_menuLayer.AddItem(new RemoveLayer(), -1, 0, false, esriCommandStyle

37、s.esriCommandStyleTextOnly);/添加“放大到整个图层”菜单项m_menuLayer.AddItem(new ZoomToLayer(), -1, 1, true, esriCommandStyles.esriCommandStyleTextOnly);/设置菜单的Hookm_menuLayer.SetHook(m_mapControl);m_menuMap.SetHook(m_mapControl);3、弹出右键菜单顾名思义，右键菜单是在鼠标右键按下的时候弹出，所以我们要添加TOCControl1控件的OnMouseDown事件，实现代码如下：private void

38、 axTOCControl1_OnMouseDown(object sender, ITOCControlEvents_OnMouseDownEvent e) /如果不是右键按下直接返回if (e.button != 2) return;esriTOCControlItem item = esriTOCControlItem.esriTOCControlItemNone;IBasicMap map = null; ILayer layer = null;object other = null; object index = null;/判断所选菜单的类型m_tocControl.HitTest

39、(e.x, e.y, ref item, ref map, ref layer, ref other, ref index);/确定选定的菜单类型，Map或是图层菜单if (item = esriTOCControlItem.esriTOCControlItemMap)m_tocControl.SelectItem(map, null);elsem_tocControl.SelectItem(layer, null);/设置CustomProperty为layer (用于自定义的Layer命令)m_mapControl.CustomProperty = layer;/弹出右键菜单if (ite

40、m = esriTOCControlItem.esriTOCControlItemMap) m_menuMap.PopupMenu(e.x, e.y, m_tocControl.hWnd);if (item = esriTOCControlItem.esriTOCControlItemLayer) m_menuLayer.PopupMenu(e.x, e.y, m_tocControl.hWnd);同样的方法，我们也可以实现主地图控件的右键菜单，以方便地图浏览。添加MapControl1控件的OnMouseDown事件，实现代码如下：/ / 主地图控件的右键响应函数/ / / private

41、void axMapControl1_OnMouseDown(object sender, IMapControlEvents2_OnMouseDownEvent e)if (e.button = 2)/弹出右键菜单m_menuMap.PopupMenu(e.x,e.y,m_mapControl.hWnd);4、编译运行按F5编译运行程序，你会发现，原来右键菜单实现起来是这么的简单啊！到第六讲为止已经发现的教程Bug及解决方法如下：1、在第二讲可能会出现变量未定义。原因：第二讲与第三讲联系紧密，我为控制篇幅才将其分为两讲，某些变量是在第三讲才进行定义，请大家注意。2、第六讲弹不出TOCCont

42、rol的右键菜单原因：没有取得m_tocControl的指针，即没有把m_tocControl指针与axTOCControl1控件绑定，导致调用m_menuMap.PopupMenu(e.x, e.y, m_tocControl.hWnd);时m_tocControl.hWnd为NULL，故无法弹出菜单。解决方法：在Form1_Load()函数中，添加如下代码：m_tocControl = (ITOCControl2)this.axTOCControl1.Object; 目前已经发现的优化方案如下：1、教程第四讲，坐标单位前面的esri，原用switch语句逐一替换，其实直接用取子串(Subs

43、tring)的方法截去更方便。修改代码如下：CoordinateLabel.Text = 当前坐标 X = + e.mapX.ToString() + Y = + e.mapY.ToString() + + this.axMapControl1.MapUnits.ToString().Substring(4);2、教程第四讲，固定状态栏中的比例尺和当前坐标项目的宽度以防止闪烁。方法如下：选中状态栏中的比例尺或当前坐标项目，把其autoSize属性设为False，再在Size属性里设置宽度。经测试，比例尺宽度为150，当前坐标宽度为400比较合适。在上一讲中，我们实现了右键菜单（ContextM

44、enu）的添加与实现，在最后我预留给下一讲的问题是TOCControl控件图层拖拽的实现。后来发现此功能的实现异常简单，只要在TOCControl的属性页中，勾选“Enable Layer Drag and Drop”即可。这一讲，我们要实现的是图层符号选择器，与ArcMap中的Symbol Selector的类似。本讲较前几讲而言，些许有些复杂，不过只要仔细琢磨，认真操作，你就很容易实现如下所示的符号选择器。因为本讲篇幅较长，故我将其分成两个阶段，本文是第一阶段。图1 在AE开发中，符号选择器有两种实现方式。一是在程序中直接调用ArcMap中的符号选择器，如下所示：图2二是自定义符号选择器，如图1所示。由于第一种方式前提是必须安装ArcGIS Desktop，其界面还是英文的，而对二次开发来说，大部分用户希望应该是中文界面。因此开发人员通常选择第二种方式，本讲也着重讲解第二种方式。通过对ArcGIS Engine+C#实例开