ArcGIS_Engine开发入门教程 c#.doc

《ArcGIS_Engine开发入门教程 c#.doc》由会员分享，可在线阅读，更多相关《ArcGIS_Engine开发入门教程 c#.doc（39页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、窗体顶端C#,ArcGIS Engine开发入门教程利用ArcGIS Engine、VS .NET和Windows控件开发GIS应用Lcwld 整理此过程说明适合那些使用.NET建立和部署应用的开发者，它描述了使用ArcGIS控件建立和部署应用的方法和步骤。你可以在下面的目录下找到相应的样例程序：DeveloperKitSamplesDeveloper_Guide_Scenarios ArcGIS_EngineBuilding_an_ArcGIS_Control_ApplicationMap_Viewer注：ArcGIS样例程序不包含在ArcGIS Engine开发工具包“典型”安装方式中。如

2、果你没有安装它们，则可以重新运行开发工具包安装向导，选择“定制”或“修改”方式，并选择软件开发包下的样例项进行安装。一、项目描述利用视窗控件建立应用程序的目标是演示并使你熟悉在微软Visual Studio .NET API中使用标准ArcGIS控件开发和部署GIS应用所需的步聚。本节中使用了Visual Studio .NET开发环境中的MapControl、 PageLayoutControl、TOCControl和ToolbarControl等视窗控件。COM、Java和C+程序员应该参考如下章节：利用ActiveX建立应用程序、利用可视化JavaBeans建立应用程序、建立命令行方式的

3、Java应用和建立命令行方式的C+应用。本节演示了创建查看ArcMap和ArcGIS桌面应用图形文档的GIS应用程序的步骤。此节包含了以下技术：l 在微软Visual Studio .NET中加载和嵌入ArcGIS控件。l 向PageLayoutControl和MapControl中加载图形文档。l 设置ToolbarControl和TOCControl的绑定控件。l 处理窗口缩放。l 向ToolbarControl添加ArcGIS Engine命令和工具。l 创建弹出式菜单l 在TOCControl中管理标签编辑l 在MapControl中绘制图形。l 为MapControl、PageLay

4、outControl和ToolbarControl创建定制工具。l 用户化ToolbarControl。l 在Windows操作系统中部署应用。二、概述本方案使用微软Visual Studio .NET开发环境加以实现，并使用了ESRI interop程序集(Interop Assemblies)，它服务于被放置在.NET窗体上的、位于.NET 窗体控件(.NET Windows Controls)中的ArcGIS控件，这些程序集在托管的.NET代码和非托管的COM代码之间起了桥梁作用。对COM ArcGIS控件(COM ArcGIS Controls)成员的引用都要经过Interop程序集，

5、然后到达实际的COM对象。同样，也从COM对象经过Interop程序集到达.NET应用程序。每个ArcGIS Engine控件具有方法、属性与事件，它们能够被控件嵌入的容器(如，.NET窗体)访问。每个控件对象及其功能可以与其他ESRI ArcObjects和自定义控件组合使用，创建用户化的客户应用程序。此方案是使用了C#和Visual Basic .NET两种语言创建，但以下技术实现集中倾向于C#方案。许多开发者可能会感觉用Visual Basic .NET更舒服，那是因为他们已经比较熟悉Visual Basic 6.0代码，然而，对于Java和C+程序员来说，他们将会觉得对C#程序语言的语

6、法更熟悉。无论你使用哪种开发环境，对于使用ArcGIS控件的好坏既依赖于你的编程环境技术，也依赖于你所掌握的ArcObjects技术。在本方案中，使用ToolbarControl、TOCControl、PageLayoutControl和MapControl来为应用程序提供用户界面。这些ArcGIS控件与其他ArcObjects和ArcGIS Engine命令被开发者一起使用，用来创建一个GIS视窗应用。三、设计此方案在设计时，首先强调了ArcGIS 控件如何互相之间进行交互，其次，向开发者解释说明了ArcGIS 控件对象模型的一部分。每个.NET ArcGIS Engine控件包含有一套能够

7、被嵌入其内的窗口即时访问的属性页。这些属性些为控件属性和方法的选择提供了捷径，并且允许开发者不写任何代码即可创建一个应用程序。本方案并没有使用属性页，而是采用写代码的方式建立应用程序。关于属性页的更进一步的信息，请参考ArcGIS开发帮助(ArcGIS Developer Help)。四、条件需求要顺利地完成以下方案，你需要以下条件（对于部署的需求将在后续的部署章节涉及到）：l 安装具有授权文件的ArcGIS Engine开发工具包(Developer Kit)，使之能够用于开发。l 安装有微软Visual Studio .NET 2003开发环境和微软.NET Framework 1.1及其

8、相应协议。l 熟悉微软Windows操作系统和Microsoft Visual Studio .NET的工作知识，会用C#或Visual Basic .NET编程语言。当然，此方案中提供了一些如何在Microsoft Visual Studio .NET中使用ArcGIS控件的信息，但它不能替代对开发环境的培训。l 不需要对ESRI其它软件有足够的经验，但如果以前对ArcObjects有所接触并对ArcGIS应用(如，ArcCatalog，ArcMap)有一个基本了解，则对于开发更有利。l 访问来自本方案的样例数据和代码，它位于：DeveloperKitSamplesDeveloper_Gui

9、de_Scenarios ArcGIS_EngineBuilding_an_ArcGIS_Control_ApplicationMap_Viewer本方案中使用到的控件和库如下：l AxMapControll AxTOCControll AxPageLayoutControll AxToolbarControll ESRI.ArcGIS.Cartol ESRI.ArcGIS.Systeml ESRI.ArcGIS.Displayl ESRI.ArcGIS.SystemUIl ESRI.ArcGIS.Geometryl ESRI.ArcGIS.Utilityl esriMapControll e

10、sriTOCControll esriPageLayoutControll esriToolbarControl五、实现下面的实现过程中提供了你成功完成方案所需所有代码。假设你对于开发环境已经有了一定的知识，所以下面没有逐步地详细介绍如何用Microsoft Visual Studio .NET开发应用。(一) 加载ArcGIS控件在你为应用程序编写代码之前，应该先将应用程序将用到的ArcGIS控件和其他ArcGIS Engine库引用装载到开发环境之中。1. 启动Visual Studio .NET，并从新建项目对话框中创建一个新的Visual C# “Windows应用程序”项目。2. 将

11、项目命名为“Controls”，并选择位置存取该项目。3. 在“工具箱”的“Windows窗体”标签栏中单击右键，然后从上下文菜单中选择“添加/移除项(I)”。4. 在“自定义工具箱”中选择“.NET Framework组件”，并复选“AxMapControl”，“AxPageLayoutControl”，“AxTOCControl”和“AxToolbarControl”，单击确定按钮。这样所选择的控件将显示在工具箱的Windows窗体标签栏中。5. 单击项目菜单，并选择“添加引用(R)”。6. 在添加引用对话框中，双击“ESRI.ArcGIS.Carto”，“ESRI.ArcGIS.Disp

12、lay”，“ESRI.ArcGIS.Geometry”，“ESRI.ArcGIS.System”，“ESRI.ArcGIS.SystemUI”，“ESRI.ArcGIS.Utility”。单击确定。注：对于ESRI .NET程序集，将通过具体实例来说明，并使用.NET框架提供的COM传送服务从你的C#项目中调用ESRI对象库中的实体对象。(二) 在容器中嵌入ArcGIS控件在你能够访问每个控件的事件、属性和方法之前，需要将控件嵌入到.NET容器中。一旦将控件嵌入窗体内，它们将图形化应用程序的用户界面。1. 在设计模式下打开.NET窗体。2. 双击工具箱Windows标签栏中的AxMapCont

13、rol控件，将MapControl加入到窗体上。3. 再将AxPageLayoutControl、AxTOCControl和AxToolbarControl如上添加到窗体中。4. 重新调整窗体上各个控件的大小和位置，调整结果如下所示。5. 在窗体上双击显示窗体代码窗口，在代码窗口的顶部增加“using”命令：using System;using System.Windows.Forms;/ ArcGIS Engine引用using ESRI.ArcGIS.SystemUI;using ESRI.ArcGIS.Carto;using ESRI.ArcGIS.Display;using ESRI.

14、ArcGIS.Geometry;using ESRI.ArcGIS.esriSystem;using ESRI.ArcGIS.ToolbarControl;using ESRI.ArcGIS.TOCControl;注：需注意C#是区分大小写的。当你键入“ESRI.”时，智能敏感的自动完成功能将允许你通过按Tab键完成下一节。(三) 加载Map文档到MapControl与PageLayoutControl 单独的数据层或者使用ArcMap、ArcGIS桌面应用程序产生的图形文档，能够被加载到MapControl和PageLayoutControl中。你可以加载样例图形文档，或者加载你自己的图形文

15、档。后面你将增加一个浏览图形文档的对话框。1. 选择Form_Load事件，并输入下列代码（如果你使用你自己的图形文档，要替换为正确的文件名）：/ 使用相对路径向PageLayoutControl加载一个图形文档string filename = .DataArcGIS_Engine_Developer_Guidegulf of st. lawrence.mxd;if ( axPageLayoutControl1.CheckMxFile(filename) )axPageLayoutControl1.LoadMxFile(filename, );2. 在设计模式显示窗体并从属性窗选择axPag

16、eLayoutControl1控件，显示axPageLayoutControl事件。在OnPageLayoutReplaced事件上双击向代码窗口添加该事件的处理函数。3. 在axPageLayoutControl1_OnPageLayoutReplaced事件中键入以下向MapControl加载样例图形文档的代码。当文档被装载入PageLayoutControl时OnPageLayoutReplaced事件将会被触发。private void axPageLayoutControl1_OnPageLayoutReplaced(object sender, ESRI.ArcGIS.PageLa

17、youtControl.IPageLayoutControlEvents_OnPageLayoutReplacedEvent e)/ 加载同样的文档到MapControlaxMapControl1.LoadMxFile(axPageLayoutControl1.DocumentFilename, null, null);/ 设置MapControl显示范围至数据的全局范围axMapControl1.Extent = axMapControl1.FullExtent;(四) 设置ToolbarControl与TOCControl控件的绑定控件对于此应用程序，TOCControl和ToolbarC

18、ontrol控件将与PageLayoutControl相互协作，而不是MapControl。为此PageLayoutControl必须设置为绑定控件。TOCControl使用绑定的ActiveView显示图形、图层和符号。而位于ToolbarControl上的任何命令、工具或菜单项会受绑定控件的显示影响。1. 在Form_Load事件中的加载文档代码的后面键入以下红色部分内容：private void Form1_Load(object sender, System.EventArgs e)/ 使用相对路径向PageLayoutControl加载一个图形文档string filename =

19、.DataArcGIS_Engine_Developer_Guidegulf of st. lawrence.mxd;if ( axPageLayoutControl1.CheckMxFile(filename) )axPageLayoutControl1.LoadMxFile(filename, );/ 设置绑定控件axTOCControl1.SetBuddyControl(axPageLayoutControl1);axToolbarControl1.SetBuddyControl(axPageLayoutControl1);2. 生成并运行应用程序。图形文档被加载到PageLayoutC

20、ontrol，并且TOCControl列出了图形文档中的数据图层。使用TOCControl通过复选和取消复选框控制图层的可见性。默认地，图形文档的焦点图(focus map)被装入MapControl控件。在这种当前情况下，ToolbarControl控件显示是空的，因为没有为它添加任何命令。试着缩放窗体，你会注意到控件不会改变尺寸。(五) 处理窗口缩放当窗口在运行时进行缩放时，PageLayoutControl和MapControl不会自动改变自身的尺寸。要改变控件的尺寸以便它们总是与匹配窗口的范围，你必须将控件锚定在窗口上。如果PageLayoutControl或MapControl包含大

21、量的数据，在窗口缩放期间重绘这些数据显得相当重要。为了提高执行效率，你可以禁止数据重绘直到缩放操作完成后再重绘之。在缩放时，可以用一个可伸缩的位图来替代重绘数据。1. 在设计模式显示窗体并从属性窗口中选择axPageLayoutControl1。单击Anchor属性，将axPageLayoutControl1锚定在窗体的顶、左、底和右部。2. 锚定axMapControl控件到窗体的顶、左和底部。3. 在Form_Load事件的开头增加以下代码：/ 当缩放时禁止重绘this.SetStyle(ControlStyles.EnableNotifyMessage, true);4. 向类增加以下常

22、量： public class Form1 : System.Windows.Forms.Form/ private const int WM_ENTERSIZEMOVE = 0x231;private const int WM_EXITSIZEMOVE = 0x232;/ 5. 向重载的OnNotifyMessage方法中增加下列代码：protected override void OnNotifyMessage(Message m)base.OnNotifyMessage (m);/ 以下为手工添加的代码if ( m.Msg = WM_ENTERSIZEMOVE)axMapControl1

23、.SuppressResizeDrawing(true, 0);axPageLayoutControl1.SuppressResizeDrawing(true, 0);else if ( m.Msg = WM_EXITSIZEMOVE)axMapControl1.SuppressResizeDrawing(false, 0);axPageLayoutControl1.SuppressResizeDrawing(false, 0);6. 生成并运行应用程序，试着缩放窗口。注：禁止缩放时重画方法是通过检查发送到窗体的Windows消息工作的。当窗口开发缩放时，Windows发送WM_ENTERSI

24、ZEMOVE窗口消息。此时，我们禁止在MapControl和PageLayoutControl上绘制图形，而是使用“stretchy bitmap”绘制。当Windows发送WM_EXITSIZEMOVE消息时，窗体结束缩放，这时我们全部重绘新的范围。(六) 向ToolbarControl增加命令ArcGIS Engine提供了120多个命令和工具，它们与MapControl、PageLayoutControl和ToolbarControl直接相互协作。这些命令和工具为你提供了大量的经常使用的地图导航、图形管理、地物选择等方面的GIS功能。现在将在你的应用程序中增加这些命令和工具的一部分。1.

25、 在Form_Load事件中的加载文档代码之前添加如下代码。/ 增加打开档命令/以下代码为头文件using System;using System.Collections.Generic;using System.ComponentModel;using System.Data;using System.Drawing;using System.Text;using System.Windows.Forms;using ESRI.ArcGIS.Carto;using ESRI.ArcGIS.Display;using ESRI.ArcGIS.Geometry;using ESRI.ArcGIS

26、.SystemUI;using ESRI.ArcGIS.esriSystem;using System.Runtime.InteropServices;/在Form_Load事件中的加载文档代码之前添加如下代码。增加打开档命令string progID;progID = esriControlToolsGeneric.ControlsOpenDocCommand;axToolbarControl1.AddItem(progID, -1, -1, false, 0,esriCommandStyles.esriCommandStyleIconOnly);/ 增加PageLayout导航命令prog

27、ID = esriControlToolsPageLayout.ControlsPageZoomInTool;axToolbarControl1.AddItem(progID, -1, -1, true, 0,esriCommandStyles.esriCommandStyleIconOnly);progID = esriControlToolsPageLayout.ControlsPageZoomOutTool;axToolbarControl1.AddItem(progID, -1, -1, true, 0,esriCommandStyles.esriCommandStyleIconOnl

28、y);progID = esriControlToolsPageLayout.ControlsPagePanTool;axToolbarControl1.AddItem(progID, -1, -1, true, 0,esriCommandStyles.esriCommandStyleIconOnly);progID = esriControlToolsPageLayout.ControlsPageZoomWholePageCommand;axToolbarControl1.AddItem(progID, -1, -1, true, 0,esriCommandStyles.esriComman

29、dStyleIconOnly);progID = esriControlToolsPageLayout.ControlsPageZoomPageToLastExtentBackCommand;axToolbarControl1.AddItem(progID, -1, -1, true, 0,esriCommandStyles.esriCommandStyleIconOnly);progID = esriControlToolsPageLayout.ControlsPageZoomPageToLastExtentForwardCommand;axToolbarControl1.AddItem(p

30、rogID, -1, -1, true, 0,esriCommandStyles.esriCommandStyleIconOnly); / 增加地图导航命令progID = esriControlToolsMapNavigation.ControlsMapZoomInTool;axToolbarControl1.AddItem(progID, -1, -1, true, 0,esriCommandStyles.esriCommandStyleIconOnly);progID = esriControlToolsMapNavigation.ControlsMapZoomOutTool;axToo

31、lbarControl1.AddItem(progID, -1, -1, true, 0,esriCommandStyles.esriCommandStyleIconOnly);progID = esriControlToolsMapNavigation.ControlsMapPanTool;axToolbarControl1.AddItem(progID, -1, -1, true, 0,esriCommandStyles.esriCommandStyleIconOnly);progID = esriControlToolsMapNavigation.ControlsMapFullExten

32、tCommand;axToolbarControl1.AddItem(progID, -1, -1, true, 0,esriCommandStyles.esriCommandStyleIconOnly);/ 使用相对路径向PageLayoutControl加载一个图形文档/ 2. 生成并运行应用程序。现在ToolbarControl包含了ArcGIS Engine命令和工具，你可以使用它们导航加载到PageLayoutControl中的图形文档。使用页面布局命令对当前的页面布局进行导航控制，要对存在于数据框架中的数据进行导航则使用地图命令。利用找开文档命令可以浏览并加载其他的图形文档。(七)

33、 给PageLayoutControl添加弹出式菜单与给跟绑定控件协作的ToolbarControl增加ArcGIS Engine命令一样，按照前面的步骤，你也可以从ArcGIS Engine命令创建弹出式菜单。下面将向你的应用程序中增加与PageLayoutControl协作的弹出式菜单。当在PageLayoutControl可视区域点击鼠标右键的时候，弹出式菜单将显示。1. 向类中添加如下的成员变量（红色部分）：public class Form1 : System.Windows.Forms.Formprivate ESRI.ArcGIS.MapControl.AxMapControl

34、axMapControl1;private ESRI.ArcGIS.PageLayoutControl.AxPageLayoutControl axPageLayoutControl1;private ESRI.ArcGIS.TOCControl.AxTOCControl axTOCControl1;private ESRI.ArcGIS.ToolbarControl.AxToolbarControl axToolbarControl1;private IToolbarMenu m_ToolbarMenu = new ToolbarMenuClass(); / 弹出式菜单/ 2. 在Form_

35、Load事件中向ToolbarControl增加命令代码的后面加载文档代码的前面增加如下代码。private void Form1_Load(object sender, System.EventArgs e)/ 前面是增加地图导航的代码/ 共享ToolbarControl的命令池m_ToolbarMenu.CommandPool = axToolbarControl1.CommandPool;/ 向ToolbarMenu增加命令progID = esriControlToolsPageLayout.ControlsPageZoomInFixedCommand;m_ToolbarMenu.Ad

36、dItem(progID, -1, -1, false,esriCommandStyles.esriCommandStyleIconAndText);progID = esriControlToolsPageLayout.ControlsPageZoomOutFixedCommand;m_ToolbarMenu.AddItem(progID, -1, -1, false,esriCommandStyles.esriCommandStyleIconAndText);progID = esriControlToolsPageLayout.ControlsPageZoomWholePageComma

37、nd;m_ToolbarMenu.AddItem(progID, -1, -1, false,esriCommandStyles.esriCommandStyleIconAndText);progID = esriControlToolsPageLayout.ControlsPageZoomPageToLastExtentBackCommand;m_ToolbarMenu.AddItem(progID, -1, -1, true,esriCommandStyles.esriCommandStyleIconAndText);progID = esriControlToolsPageLayout.

38、ControlsPageZoomPageToLastExtentForwardCommand;m_ToolbarMenu.AddItem(progID, -1, -1, false,esriCommandStyles.esriCommandStyleIconAndText);/ 设置与PageLayoutControl挂接m_ToolbarMenu.SetHook(axPageLayoutControl1);/ 后面是加载图形文档的代码/ 3. 在设计模式显示窗体并从属性窗口中选择axPageLayoutControl1，显示axPageLayoutControl事件。双击OnMouseDow

39、n事件，向代码窗口中增加事件处理代码。4. 在axPageLayoutControl1_OnMouseDown事件中增加如下代码：private void axPageLayoutControl1_OnMouseDown(object sender, ESRI.ArcGIS.PageLayoutControl.IPageLayoutControlEvents_OnMouseDownEvent e)/ 弹出ToolbarMenuif ( e.button = 2)m_ToolbarMenu.PopupMenu(e.x, e.y, axPageLayoutControl1.hWnd);5. 生成并

40、运行应用程序。在PageLayoutControl的显示区域单击右键以显示弹出菜单，并为页面布局导航。 (八) 在TOCControl中控制标签编辑TOCControl默认允许用户自动地切换图层的可见性并改变显示在目录表中的名称。你可以增加代码防止用户在编辑名称时输入空的字符串。1. 在Form_Load事件的开始增加下列代码。private void Form1_Load(object sender, System.EventArgs e)/ 当缩放时禁止重绘this.SetStyle(ControlStyles.EnableNotifyMessage, true);/ 设置标签编辑为手动方

41、式axTOCControl1.LabelEdit = esriTOCControlEdit.esriTOCControlManual;/ 后面是加载文档代码/ 2. 在设计模式显示窗体并从属性窗口选择AxTOCControl1控件，显示AxTOCControl事件。双击OnEndLabelEdit向代码窗口添加事件处理函数。3. 在axTOCControl1_OnEndLabelEdit事件中添加以下代码：private void axTOCControl1_OnEndLabelEdit(object sender, ESRI.ArcGIS.TOCControl.ITOCControlEven

42、ts_OnEndLabelEditEvent e)/ 禁止在编辑标签时键入空字串string newLabel = e.newLabel;if ( newLabel.Trim() = )e.canEdit = false;4. 生成并生成应用程序。编辑TOCControl控件的地图、图层、标题或图例类的标签，在其上点击一次，然后再点一次调用标签编辑。试着用空字串替代标签。在编辑期间，你可以随时使用键盘上的ESC键取消编辑。(九) 在MapControl上绘制图形你可以将MapControl作为缩略图窗体使用，并在其上绘制显示PageLayoutControl内的焦点地图的当前范围。当你浏览Pa

43、geLayoutControl数据框架内的数据时，你将看到缩略图窗口也进行了更新。注：使用地图导航工具导航焦点图（活动图）将改变PageLayoutControl中焦点地图的范围并引起MapControl更新。使用页面布局工具导航页面布局将改变页面布局的范围（不是PageLayoutControl中的焦点图的范围），而MapControl将不更新。1. 向类中增加下列成员变量：public class Form1 : System.Windows.Forms.Formprivate ESRI.ArcGIS.MapControl.AxMapControl axMapControl1;privat

44、e ESRI.ArcGIS.PageLayoutControl.AxPageLayoutControl axPageLayoutControl1;private ESRI.ArcGIS.TOCControl.AxTOCControl axTOCControl1;private ESRI.ArcGIS.ToolbarControl.AxToolbarControl axToolbarControl1;private IToolbarMenu m_ToolbarMenu = new ToolbarMenuClass(); / 弹出式菜单private IEnvelope m_Envelope;/ MapControl绘制的范围private Object m_FillSymbol;/ 在MapControl上绘制范围使用的符号private ITransformEvents_VisibleBoundsUpdatedEventHandlervisBoundsUpdatedE;/ PageLayoutControl的焦点图事件注：声明的变量visBoundsUpdatedE是一个托管。托管是一个类，它能够拥有对指定