ArcGISEngine-C#实例开发教程.pdf

《ArcGISEngine-C#实例开发教程.pdf》由会员分享，可在线阅读，更多相关《ArcGISEngine-C#实例开发教程.pdf（76页珍藏版）》请在得力文库 - 分享文档赚钱的网站上搜索。

1、ArcGIS Engine+C#实例开发教程第一讲：桌面GIS应用程序框架的建立本讲主要是使用 MapControL PageLayoutControl ToolbarControK TOCControl 四个控件建立起基本的桌面GIS应用程序框架。最终成果预览如下：1、新建项目启动VS2005,选 择“文件|新建|项目”,在项目类型中选择Visual C#,再选择Windows应用程序模板，输入名称“3sdnM叩”，点击确定。田 因新建项目在解决方案管理器中将“Forml.cs”重命名为“3sdnMap.cs”，在设计视图中，选中窗体,将其属性中的“Text”改 为“3sdnMap”。2、添

2、加控件选择工具箱中的“菜单和工具栏|MenuStrip”，将其拖入窗体。选择工具箱中的ArcGIS Windows Forms”节,将 Toolbarcontrol”控件拖入窗体,并将其属性中的Dock设置为Top。选择工具箱中的“菜单和工具栏|Statusstrip”，将其拖入到窗体。选择工具箱中的“容器|Splitcontainer”容器拖入窗体，并将其属性中的Dock设置为Fill。将 TabControl控件拖入P a n e ll,将 Alignment属性设置为Bottom,Dock属性设置为Fill。点击 TabPages属性右边的按钮，弹 出 TabPage集合编辑器，将 ta

3、b P a g e l的 Nam e设置为tabPageLayer,Text 设置为图层，将 tabPage2 的 Name 设置为 tabPageProperty,Text 设置为属性。如下所示。选 择“图层”选项卡，拖入TOCControl控件，设置Dock属性为Fill。选择 属性 选项卡，拖 入 DataGridView控 件,设 置 Dock属性为Fill。拖入TabControl控件到Panel2,设置Dock属性为Fill。并上述类似的方法，将两个选项卡的Name 和 Text 分别设置为：（tabPageMap、地图），（tabPageLayout,制版）。选 择“地图”选项卡

4、，拖 入 MapControl控 件,设 置 Dock属性为Fill。选 择“制版”选 项 卡,拖 入 PageLayoutControl控 件,设 置 Dock属性为Fillo最后将Licensecontrol控件拖入到窗体的任意地方。按 F5编译运行，可以看到刚才布局好的程序界面了。3、控件绑定通过以上步骤添加的控件还只是单独存在，而我们的程序需要各控件间协同工作，因此要进行控件绑定。分别右击Toolbarcontrol、TOCControl控 件,将 Buddy设置为axM叩Control!.,如下图所示。这样，工具条和图层控件就与地图捽件关联了。4、添加工具此时，工具条中还没有任何工具

5、，添加的方法也很简单。右 击 Toolbarcontrol,选 择“属性|It e m s 点击 A d d,选择 Commands 选项卡中的 Generic,双击 Open、SaveAs、Redo、Undo即可将相应工具添加到工具条。常见的工具有：Map Navigation中的导航工具，Map Inquiry中的查询工具，Feature Selection中的选择工具,你可以根据需要酌情添加工具。5、编译运行按F5即可编译运行程序，至此桌面GIS应用程序框架基本框架已经搭建好了，你可以通过工具条的工具打开地图文档，浏览地图了，效果如开篇所示.第二讲菜单的添加及其实现在上一讲中，我们实现了

6、应用程序基本框架，其中有个小错误，在此先跟大家说明下。在“属性”选项卡中，我们当时添加的是DataGridView控件，这个控件是用来显示数据表的，而专门用于属性的查询和设置的控件是PropertyGrid控件。因此请你删除“属性”选项卡中的DataGridView控件，再把位于“工 具 箱|所 有Windows窗 体|PropertyGrid”（如果没有，右击选择“选择项”以添加此控件）控件拖到该选项卡。在这一讲中，主要讲解菜单的添加和实现。1、添加菜单在设计视图中，单击菜单栏，会出现“请在此处键入”的提示，单击提示就可以键入菜单名称，如“文件”，再单击“文件”，即可输入其下拉子菜单，如下所

7、示：Tips：每创建一个菜单，请在其属性面板中设置Name属性，而且不要为中文，因 此Name值将是此菜单响应函数的函数名的一部分，带中文的函数名，总是不好吧。本讲中，我们将添加新建（New）、打开（Open）、添加数据（AddData）、保存（Save）、另 存 为（SaveAs）、退 出（Exit）这些菜单，（）内为相应的Name属性值。Tips:你可以在属性面板中的Text属性中，把菜单名设置为中英文形式，如“打 开Open”,带下划线的0表示此项菜单的快捷键是字母。，设置方法是在相应字母前加上“&”字符,如“打 开&Open”。但这种快捷键只在打开此下拉菜单时才有效，即当你单击“文件”

8、菜单弹出下拉菜单时，按 下 字 母。就可以定位到“打开”菜单。还有一种在程序运行时都有效的全局快捷键，可以在属性面板中的“ShortCutKeys”中设置。你还可以在属性面板中的Image属性中设置你喜欢的菜单图标。单 击Image那一行右边的按钮，弹出如下菜单。选 择“项目资源文件”，再单击导入就可以选择你的图标了。最终效果如下所示。ontrolss制版JJ胃口触-新 建New打 开Open添加数据Add Data保 存Save另存为Save AsSArcGIS IName:;退 出Exit匚 二 二 二 二 二3注意，在解决方案面板中，选中刚才添加的所有图标，在其属性面板中将生成操作设置为

9、“嵌入的资源”，这一点很重要！2、实现相关菜单首先定义指针(写在public partial class Form l:Form 下面即可):private ESRI.ArcGIS.Controls.lMapControl3 m_mapControl=null;private ESRI.ArcGIS.Controls.lPageLayoutControl2 m_pageLayoutControl=null;private IMapDocument pMapDocument;若以上指针无效，请添加以下引用：using ESRI.ArcGIS.Carto;using ESRI.ArcGIS.Con

10、trols;using ESRI.ArcGIS.esriSystem;using ESRI.ArcGIS.Display;using ESRI.ArcGIS.Geometry;using ESRI.ArcGIS.Systemlll;在设计视图中的属性面板中，选 择 Forml,即主窗体，单击事件按钮(闪电形状的那个按钮)，打 到“Load”事件并双击，添加此事件。在 Forml_Load函数中初始化这些指针：/取得 MapControl 和 PageLayoutControl 的引用m_mapControl=(IMapControl3)this.axMapControll.Object;m_p

11、ageLayoutControl=(IPageLayoutControl2)this.axPageLayoutControll.Object;依次双击每个菜单项，添加菜单响应函数。实现代码如卜 ：III III新建地图命令III/III private void New_Click(object sender,Eve nt Args e)(/本命令涉及到MapControl和 PageLayoutControl同步问题，将在下讲中实现)III I I I 打开地图文档M xd命令III/private void Open_Click(object sender;Eve nt Args e)(/

12、本命令涉及到MapControl和 PageLayoutControl同步问题，将在下一讲中实现)III I I I 添加数据命令III III III private void AddData_Click(object sender,Eve nt Args e)int currentLayerCount=this.axMapControll.LayerCount;ICommand pCommand=new ControlsAddDataCommandClass();pCommand.OnCreate(this.axMapControll.Object);pCommand.OnClick();

13、III III保存地图文档命令/III/private void Save_Click(object sender,EventArgs e)(/首先确认当前地图文档是否有效if(null!=m_pageLayoutControl.DocumentFilename&m_mapControl.CheckMxFile(m_pageLayoutControl.DocumentFilename)(/创建一个新的地图文档实例IMapDocument mapDoc=new MapDocumentClass();/打开当前地图文档mapDoc.Open(m_pageLayoutControl.Document

14、Filename/string.Empty);/用 PageLayout中的文档替换当前文档中的PageLayout部分mapDoc.ReplaceContents(IMxdContents)m_pageLayoutControl.PageLayout);/保存地图文档mapDoc.SavefmapDoc.UsesRelativePaths,false);mapDoc.Close();)/另存为地图文档命令/III private void SaveAs_Click(object sendee EventArgs e)/调用另存为命令ICommand command=new ControlsS

15、aveAsDocCommandClass();command.OnCreate(m_controlsSynchronizer.ActiveControl);command.OnClick();)/III退出程序/III III private void Exit_Click(object sender,Eve nt Args e)Application.Exit();3、编译运行按 F 5 编译运行程序。也许你会发现，菜单命令的实现方式都是类型的。没错，在 AE9.2中，内 置 了 许 多 常 用 的 Command 和 Tool,如 ControlsAddDataCommandClass、C

16、ontrolsMapZoomlnToolClass、ControlsMapPanToolClass 等 等，这 些 内 置 对 象 在ESRI.ArcGIS.Controls命名空间中，你可以对象浏览器中查看。而且这些内置对象的调用方式都类似，如下所示：/定义ICommand command=new ControlsSaveAsDocCommandClass();/创建command.OnCreate(m_controlsSynchronizer.ActiveControl);/调用command.OnClick();第三讲 M叩Control 与 PageLayoutControl 同步在

17、ArcMap中，能够很方面地进行MapView和 Layout View两种视图的切换，而且二者之间的数据是同步显示的。关于两种视图同步的实现方法有多种，可以使用Objectcopy对象进行数据硬拷贝，而比较简单的方法莫过于二者共享一份地图了，这也是最常用的方法。1、新建同步类 ControlsSynchronizer在解决方案面板中右击项目名，选 择“添加|类”，在类别中选择“Visual C#项目项，在模板中选择“类”,输入类名“ControlsSynchronizer.cs，将以下代码覆盖自动生成的代码：using System;using System.Drawing;using Sy

18、stem.Collections;using System.ComponentModel;using System.Windows.Forms;using System.IO;using System.Runtime.InteropServices;using ESRI.ArcGIS.esriSystem;using ESRI.ArcGIS.Carto;using ESRI.ArcGIS.Controls;using ESRI.ArcGIS.SystemUI;namespace _sdnMap(/III This class is used to synchronize a gven Page

19、LayoutControl and a MapControl.Ill When initialized,the user must pass the reference of these control to the class,bindIII the control together by calling BindControls*which in turn sets a joined Map referenced/by both control;and set all the buddy controls joined between these two controls.Ill When

20、 alternating between the MapControl and PageLayoutControl,you should activatethe visible control/and deactivate the other by calling ActivateXXX./This calss is limited to a situation where the controls are not simultaneously visible./public class ControlsSynchronizer(#region class membersprivate IMa

21、pControl3 m_mapControl=null;private I Page LayoutControl2 m_pageLayoutControl=null;private ITool m_mapActiveTool=null;private ITool m_pageLayoutActiveTool=null;private bool mJsMapCtrlactive=true;private ArrayList m_frameworkControls=null;#endregion#region constructorIII III默认构造函数III public ControlsS

22、ynchronizer()初始化 ArrayListm_frameworkControls=new ArrayList();)Ill III构造函数III/III public ControlsSynchronizer(IMapControl3 mapControl,IPageLayoutControl2pageLayoutControl):this()(为类成员赋值m_mapControl=mapControl;m_page Layou tCo nt ro I=pageLayoutControl;)#endregion#region propertiesIII III取得或设置MapCont

23、rolIII public IMapControl3 MapControl(get return m_mapControl;set m_mapControl=value;/取得或设置 PageLayoutControl/public IPageLayoutControl2 PageLayoutControl(get return m_pageLayoutControl;set m_pageLayoutControl=value;III III取得当前ActiveView的类型/public string ActiveViewTypegetif(m JsMapCtrlactive)return

24、MapControl*;elsereturn PageLayoutControl;)III I I I 取得当前活动的ControlIII public object ActiveControl(get(if(m_mapControl=null 1 1 m_pageLayoutControl=null)throw new Exception(ControlsSynchronizer:ActiveControl:rnEitherMapControl or PageLayoutControl are not initialized!);if(mJsMapCtrlactive)return m_ma

25、pControl.Object;elsereturn m_pageLayoutControl.Object;)#endregion#region MethodsIII III 激活 MapControl 并解除 the PagleLayoutControlIII public void ActivateMap()(try(if(m_pageLayoutControl=null 1 1 m_mapControl=null)throw new Exception(uControlsSynchronizer:ActivateMap:rnEitherMapControl or PageLayoutCo

26、ntrol are not initialized!);缓存当前 PageLayout 的 CurrentToolif(m_pageLayoutControl.CurrentTool!=null)m_pageLayoutActiveIbol=m_pageLayoutControl.CurrentTool;解除 PagleLayoutm_pageLayoutControl.ActiveView.Deactivate();激活 MapControlm_mapControl.ActiveView.Activate(m_mapControl.hWnd);将之前M叩Control最后使用的too l,作

27、为活动的to o l,赋给MapControl的 CurrentToolif(m_mapActiveTool!=null)m_mapControl.CurrentTool=m_mapActiveTool;mJsMapCtrlactive=true;为每个的 framework controls,设置 Buddy control 为 MapControlthis.SetBuddies(m_mapControl.Object);)catch(Exception ex)(throw newException(string.Format(ControlsSynchronizer:ActivateMap

28、:rn0,ex.Message);)/激活 PagleLayoutControl 并减活 MapCotrol/public void ActivatePageLayout()(tryif(m_pageLayoutControl=null 1 1 m_mapControl=null)throw newException(ControlsSynchronizer:ActivatePageLayout:rnEither MapControl orPageLayoutControl are not initialized!);缓存当前 MapControl 的 CurrentToolif(m_mapC

29、ontrol.CurrentTool!=null)m_mapActiveTool=m_mapControl.CurrentTool;解除 MapControlm_mapControl.ActiveView.Deactivate();激活 Pa ge Layo u t Co nt ro Im_pageLayoutControl.ActiveView.Activate(m_pageLayoutControl.hWnd);将之前PageLayoutControl最后使用的to o l,作为活动的to o l,赋给PageLayoutControl 的 CurrentToolif(m_pageLayo

30、utActiveTool!=null)m_pageLayoutControl.CurrentTool=m_pageLayoutActiveTool;m_lsMapCtrlactive=false;为每一个的 framework controls,设置 Buddy control 为 PageLayoutControlthis.SetBuddies(m_pageLayoutControl.Object);)catch(Exception ex)(throw newExceptiontstring.FormatCControlsSynchronizerActivatePageLayoutArXnf

31、O,ex.Message);)/III 给予一个地图，置换 PageLayoutControl 和 MapControl 的 focus map/public void ReplaceMap(IMap newMap)(if(newMap=null)throw new Exception(ControlsSynchronizer:ReplaceMap:rnNew map forreplacement is not initialized!);if(m_pageLayoutControl=null 1 1 m_mapControl=null)throw new Exception(Controls

32、Synchronizer:Replacel/lap:rnEitherMapControl or PageLayoutControl are not initialized!);/create a new instance of IMaps collection which is needed by the PageLayout 创 建 个PageLayout需要用到的，新 的 IMaps collection的实例IMaps maps=new Maps();/add the new map to the Maps collection把新的地图加到Maps collection里头去maps.

33、Add(newMap);bool blsMapActive=mJsMapCtrlactive;/call replace map on the PageLayout in order to replace the focus map/we must call Activate Page Layout,since it is the control we call ReplaceMaps调用 PageLayout 的 replace map 来置换 focus map我们必须调用ActivatePageLayout,因为它是那个我们可以调用“ReplaceMaps”的 Controlthis.A

34、ctivatePageLayout();m_pageLayoutControl.PageLayout.ReplaceMaps(maps);/assign the new map to the MapControl把新的地图赋给MapControlm_mapControl.Map=newMap;/reset the active tools重设 active toolsm_pageLayoutActiveTool=null;m_mapActiveTool=null;/make sure that the last active control is activated确认之前活动的control

35、被激活if(blsMapActive)(this.ActivateMap();m_mapControl.ActiveView.Refresh();)else(this.ActivatePageLayout();m_pageLayoutControl.ActiveView.Refresh();)III/bind the MapControl and PageLayoutControl together by assigning a new joint focusmapIII 指定共同的 Map 来把 MapControl 和 PageLayoutControl 绑在一起III/III/true

36、if the MapControl supposed to be activatedfirst,如果 MapControl 被首先激活，则为 truepublic void BindControls(IMapControl3 mapControl,IPageLayoutControl2PageLayoutControl,bool activateMapFirst)(if(mapControl=null 1 1 PageLayoutControl=null)throw new Exception(ControlsSynchronizer:BindControls:rnEitherMapContr

37、ol or PageLayoutControl are not initialized!);m_mapControl=MapControl;m_pageLayoutControl=PageLayoutControl;this.BindControls(activateMapFirst);)Ill III bind the MapControl and PageLayoutControl together by assigning a new joint focusmapIII 指定共同的 Map 来把 MapControl 和 PageLayoutControl 绑在一起III/true if

38、 the MapControl supposed to be activatedfirst,如果 MapControl 被首先激活，则为 truepublic void BindControls(bool activateMapFirst)(if(m_pageLayoutControl=null 1 1 m_mapControl=null)throw new Exception(ControlsSynchronizer:BindControls:rnEitherMapControl or PageLayoutControl are not initialized!);/create a new

39、 instance of IMap创造IMap的一个实例IMap newMap=new MapClass();newMap.Name=Map;/create a new instance of I Maps collection which is needed by the PageLayout创造一个新的IM叩s collection的实例，这 是 PageLayout所需要的IMaps maps=new Maps();/add the new Map instance to the Maps collection把新的Map实例赋给Maps collectionmaps.Add(newMa

40、p);/call replace map on the PageLayout in order to replace the focus map调用 PageLayout 的 replace map 来置换 focus mapm_pageLayoutControl.PageLayout.ReplaceMaps(maps);/assign the new map to the MapControl把新的map赋 给 MapControlm_mapControl.Map=newMap;/reset the active tools重设 active toolsm_pageLayoutActiveT

41、ool=null;m_mapActiveTool=null;/make sure that the last active control is activated确定最后活动的control被激活if(activateMapFirst)this.ActivateMap();elsethis.ActivatePageLayout();Ill/by passing the applications toolbars and TOC to the synchronization class,it savesyou the/management of the buddy control each t

42、ime the active control changes.Thismethod ads the framework/control to an array;once the active control changes,the class iterates through thearray and/calles SetBuddyControl on each of the stored framework control./III public void AddFrameworkControl(object control)(if(control=null)throw newExcepti

43、on(ControlsSynchronizer:AddFrameworkControl:rnAdded control is not initialized!);m_frameworkControls.Add(control);)III/Remove a framework control from the managed list of controlsIII/public void RemoveFrameworkControl(object control)(if(control=null)throw newException(ControlsSynchronizer:RemoveFram

44、eworkControl:rnControl to be removed is notinitialized!);m_frameworkControls.Remove(control);)/III Remove a framework control from the managed list of controls by specifying itsindex in the listIII/public void RemoveFrameworkControlAt(int index)if(m_frameworkControls.Count index)throw newException(C

45、ontrolsSynchronizer:RemoveFrameworkControlAt:rnlndex is out of range!);m_frameworkControls.RemoveAt(index);)III III when the active control changes,the class iterates through the array of theframework controls/and calles SetBuddyControl on each of the controls./III the active controlprivate void Set

46、Buddies(object buddy)(try(if(buddy=null)throw new Exception(ControlsSynchronizer:SetBuddies:rnTargetBuddy Control is not initialized!);foreach(object obj in m_frameworkControls)(if(obj is I Toolbarcontrol)(IToolbarControl)obj).SetBuddyControl(buddy);else if(obj is ITOCControl)(ITOCControl)obj).SetBu

47、ddyControl(buddy);)catch(Exception ex)(throw newException(string.Format(ControlsSynchronizer:SetBuddies:rn0/ex.Message);)#endregion2、新建Maps类在同步类中，要用到Maps类，用于管理地图对象。与新建同步类ControlsSynchronizer类似,我们新建一 Maps类，其所有代码如下所示:using System;using System.Collections;using System.Collections.Generic;using System.T

48、ext;using System.Runtime.InteropServices;using ESRI.ArcGIS.Carto;namespace _sdnMap(Guid(f27d8789-fbbc-4801-be78-0e3cd8fff9d5)Classlnterface(ClasslnterfaceType.None)Progld(_sdnMap.Maps)public class Maps:IMaps,IDisposable(/class member-using internally an ArrayList to manage the Maps collectionprivate

49、 ArrayList m_array=null;#region class constructorpublic Maps()(m_array=new ArrayList();)#endregion#region IDisposable Members/Dispose the collectionIII public void Dispose()(if(m_array!=null)(m_array.Clear();m_array=null;)#endregion#region IMaps MembersIll III Remove the Map at the given index/publi

50、c void RemoveAt(int Index)(if(Index m_array.Count 1 1 Index 0)throw new Exception(Maps:RemoveAt:rnlndex is out of range!*);m_a rray.RemoveAt(lndex);)/III Reset the Maps arrayIII public void Reset()(m_array.Clear();)III III Get the number of Maps in the collection/public int Count(get(return m_array.