当前位置：搜档网 › C#,ArcGIS Engine开发入门教程

C#,ArcGIS Engine开发入门教程

利用ArcGIS Engine、VS .NET和Windows控件开发GI

S应用

Dixon整理

此过程说明适合那些使用.NET建立和部署应用的开发者，它

描述了使用ArcGIS控件建立和部署应用的方法和步骤。

你可以在下面的目录下找到相应的样例程序：

<安装目录>\DeveloperKit\Samples\Developer_Guide_Scenarios\ ArcGIS_Engine\Building_an_ArcGIS_Control_Application\Map_Vie

wer

注：ArcGIS样例程序不包含在ArcGIS Engine开发工具包“典

型”安装方式中。如果你没有安装它们，则可以重新运行开发工具

包安装向导，选择“定制”或“修改”方式，并选择软件开发包下

的样例项进行安装。

一、项目描述

利用视窗控件建立应用程序的目标是演示并使你熟悉在微软V

isual Studio .NET API中使用标准ArcGIS控件开发和部署GIS应

用所需的步聚。本节中使用了Visual Studio .NET开发环境中的M apControl、PageLayoutControl、TOCControl和ToolbarControl等

视窗控件。COM、Java和C++程序员应该参考如下章节：利用Ac

tiveX建立应用程序、利用可视化JavaBeans建立应用程序、建立

命令行方式的Java应用和建立命令行方式的C++应用。

本节演示了创建查看ArcMap和ArcGIS桌面应用图形文档的G

IS应用程序的步骤。此节包含了以下技术：

●在微软Visual Studio .NET中加载和嵌入ArcGIS控件。

●向PageLayoutControl和MapControl中加载图形文档。

●设置ToolbarControl和TOCControl的绑定控件。

●处理窗口缩放。

●向ToolbarControl添加ArcGIS Engine命令和工具。

●创建弹出式菜单

●在TOCControl中管理标签编辑

●在MapControl中绘制图形。

●为MapControl、PageLayoutControl和ToolbarControl创建定制工

具。

●用户化ToolbarControl。

●在Windows操作系统中部署应用。

二、概述

本方案使用微软Visual Studio .NET开发环境加以实现，并使用了ESRI interop程序集(Interop Assemblies)，它服务于被放置在.

NET窗体上的、位于.NET 窗体控件(.NET Windows Controls)中的ArcGIS控件，这些程序集在托管的.NET代码和非托管的COM代码之间起了桥梁作用。对COM ArcGIS控件(COM ArcGIS Contr ols)成员的引用都要经过Interop程序集，然后到达实际的COM对象。同样，也从COM对象经过Interop程序集到达.NET应用程序。

每个ArcGIS Engine控件具有方法、属性与事件，它们能够被控件嵌入的容器(如，.NET窗体)访问。每个控件对象及其功能可以与其他ESRI ArcObjects和自定义控件组合使用，创建用户化的客户应用程序。

此方案是使用了C#和Visual Basic .NET两种语言创建，但以下技术实现集中倾向于C#方案。许多开发者可能会感觉用Visual Basic .NET更舒服，那是因为他们已经比较熟悉Visual Basic 6.0代码，然而，对于Java和C++程序员来说，他们将会觉得对C#程序语言的语法更熟悉。无论你使用哪种开发环境，对于使用ArcGI S控件的好坏既依赖于你的编程环境技术，也依赖于你所掌握的A rcObjects技术。

在本方案中，使用ToolbarControl、TOCControl、PageLayoutControl 和MapControl来为应用程序提供用户界面。这些ArcGIS控件与其他Ar

cObjects和ArcGIS Engine命令被开发者一起使用，用来创建一个GIS 视窗应用。

三、设计

此方案在设计时，首先强调了ArcGIS 控件如何互相之间进行交互，其次，向开发者解释说明了ArcGIS 控件对象模型的一部分。

每个.NET ArcGIS Engine控件包含有一套能够被嵌入其内的窗口即时访问的属性页。这些属性些为控件属性和方法的选择提供了捷径，并且允许开发者不写任何代码即可创建一个应用程序。本方案并没有使用属性页，而是采用写代码的方式建立应用程序。关于属性页的更进一步的信息，请参考ArcGIS开发帮助(ArcGIS De veloper Help)。

四、条件需求

要顺利地完成以下方案，你需要以下条件（对于部署的需求将在后续的部署章节涉及到）：

●安装具有授权文件的ArcGIS Engine开发工具包(Developer Ki

t)，使之能够用于开发。

●安装有微软Visual Studio .NET 2003开发环境和微软.NET Fra

mework 1.1及其相应协议。

●熟悉微软Windows操作系统和Microsoft Visual Studio .NET的

工作知识，会用C#或Visual Basic .NET编程语言。当然，此方

案中提供了一些如何在Microsoft Visual Studio .NET中使用Ar

cGIS控件的信息，但它不能替代对开发环境的培训。

●不需要对ESRI其它软件有足够的经验，但如果以前对ArcObje

cts有所接触并对ArcGIS应用(如，ArcCatalog，ArcMap)有一个

基本了解，则对于开发更有利。

●访问来自本方案的样例数据和代码，它位于：

<安装目录>\DeveloperKit\Samples\Developer_

Guide_Scenarios\ ArcGIS_Engine\Building_an_Arc

GIS_Control_Application\Map_Viewer

本方案中使用到的控件和库如下：

●AxMapControl●AxTOCControl

●AxPageLayoutControl●AxToolbarControl

●ESRI.ArcGIS.Carto●ESRI.ArcGIS.System

●ESRI.ArcGIS.Display●ESRI.ArcGIS.SystemUI

●ESRI.ArcGIS.Geometry●ESRI.ArcGIS.Utility

●esriMapControl●esriTOCControl

●esriPageLayoutControl●esriToolbarControl

五、实现

下面的实现过程中提供了你成功完成方案所需所有代码。假设你对于开发环境已经有了一定的知识，所以下面没有逐步地详细介

绍如何用Microsoft Visual Studio .NET开发应用。

(一) 加载ArcGIS控件

在你为应用程序编写代码之前，应该先将应用程序将用到的A rcGIS控件和其他ArcGIS Engine库引用装载到开发环境之中。

1.启动Visual Studio .NET，并从新建项目对话框中创建一个新的

Visual C# “Windows应用程序”项目。

2.将项目命名为“Controls”，并选择位置存取该项目。

3.在“工具箱”的“Windows窗体”标签栏中单击右键，然后从上

下文菜单中选择“添加/移除项(I)…”。

4.在“自定义工具箱”中选择“.NET Framework组件”，并复选

“AxMapControl”，“AxPageLayoutControl”，“AxTOCContr

ol”和“AxToolbarControl”，单击确定按钮。这样所选择的控件

将显示在工具箱的Windows窗体标签栏中。

5.单击项目菜单，并选择“添加引用(R)…”。

6.在添加引用对话框中，双击“ESRI.ArcGIS.Carto”，“ESRI.Arc

GIS.Display”，“ESRI.ArcGIS.Geometry”，“ESRI.ArcGIS.Sys

tem”，“ESRI.ArcGIS.SystemUI”，“ESRI.ArcGIS.Utility”。

单击确定。

注：对于ESRI .NET程序集，将通过具体实例来说明，并使用.NET框架提供的COM传送服务从你的C#项目中调用ESR

I对象库中的实体对象。

(二) 在容器中嵌入ArcGIS控件

在你能够访问每个控件的事件、属性和方法之

前，需要将控件嵌入到.NET容器中。一旦将控件

嵌入窗体内，它们将图形化应用程序的用户界面。

1.在设计模式下打开.NET窗体。

2.双击工具箱Windows标签栏中的AxMapControl控件，将M

apControl加入到窗体上。

3.再将AxPageLayoutControl、AxTOCControl和AxToolbarCo

ntrol如上添加到窗体中。

4.重新调整窗体上各个控件的大小和位置，调整结果如下所

示。

5.在窗体上双击显示窗体代码窗口，在代码窗口的顶部增加“u

sing”命令：

using System;

using System.Windows.Forms;

// ArcGIS Engine引用

using ESRI.ArcGIS.SystemUI;

using ESRI.ArcGIS.Carto;

using ESRI.ArcGIS.Display;

using ESRI.ArcGIS.Geometry;

using ESRI.ArcGIS.esriSystem;

using ESRI.ArcGIS.ToolbarControl;

using ESRI.ArcGIS.TOCControl;

注：需注意C#是区分大小写的。当你键入“ESRI.”时，智能敏感的自动完成功能将允许你通过按Tab键完成下一节。(三) 加载Map文档到MapControl与Pag eLayoutControl

单独的数据层或者使用ArcMap、ArcGIS桌面应用程序产生的图形文档，能够被加载到MapControl和PageLayoutControl中。你可以加载样例图形文档，或者加载你自己的图形文档。后面你将增加一个浏览图形文档的对话框。

1.选择Form_Load事件，并输入下列代码（如果你使用你自己

的图形文档，要替换为正确的文件名）：

// 使用相对路径向PageLayoutControl加载一个图形文档

string filename = @"..\..\..\..\..\..\..\..\Data\\ArcGIS_Engin e_Developer_Guide\\gulf of st. lawrence.mxd";

if ( axPageLayoutControl1.CheckMxFile(filename) )

{

axPageLayoutControl1.LoadMxFile(filename, "");

}

2.在设计模式显示窗体并从属性窗选择axPageLayoutControl1

控件，显示axPageLayoutControl事件。在OnPageLayoutRe

placed事件上双击向代码窗口添加该事件的处理函数。

3.在axPageLayoutControl1_OnPageLayoutReplaced事件中键入以下向M

apControl加载样例图形文档的代码。当文档被装载入PageLayoutCont

rol时OnPageLayoutReplaced事件将会被触发。

private void axPageLayoutControl1_OnPageLayoutReplaced(object sender, ESRI.ArcGIS.PageLayoutControl.IPageLayoutControlEvents_OnPageLayou tReplacedEvent e)

{

// 加载同样的文档到MapControl

axMapControl1.LoadMxFile(axPageLayoutControl1.DocumentFil ename, null, null);

// 设置MapControl显示范围至数据的全局范围

axMapControl1.Extent = axMapControl1.FullExtent;

}

(四) 设置ToolbarControl与TOCControl控件的绑定控件

对于此应用程序，TOCControl和ToolbarCont

rol控件将与PageLayoutControl相互协作，而不是

MapControl。为此PageLayoutControl必须设置为

绑定控件。TOCControl使用绑定的ActiveView显

示图形、图层和符号。而位于ToolbarControl上的

任何命令、工具或菜单项会受绑定控件的显示影

响。

1.在Form_Load事件中的加载文档代码的后面键入以下红色

部分内容：

private void Form1_Load(object sender, System.EventArgs e)

{

// 使用相对路径向PageLayoutControl加载一个图形文档

string filename = @"..\..\..\..\..\..\..\..\Data\\ArcGIS_ Engine_Developer_Guide\\gulf of st. lawrence.mxd";

if ( axPageLayoutControl1.CheckMxFile(filename) )

{

axPageLayoutControl1.LoadMxFile(filename, "");

}

// 设置绑定控件

axTOCControl1.SetBuddyControl(axPageLayoutControl1);

axToolbarControl1.SetBuddyControl(axPageLayoutControl1);

}

2.生成并运行应用程序。图形文档被加载到PageLayoutControl，并且TO

CControl列出了图形文档中的数据图层。使用TOCControl通过复选和

取消复选框控制图层的可见性。默认地，图形文档的焦点图(focus map)

被装入MapControl控件。在这种当前情况下，ToolbarControl控件显

示是空的，因为没有为它添加任何命令。试着缩放窗体，你会注意到控

件不会改变尺寸。

(五) 处理窗口缩放

当窗口在运行时进行缩放时，PageLayoutCont

rol和MapControl不会自动改变自身的尺寸。要改

变控件的尺寸以便它们总是与匹配窗口的范围，你

必须将控件锚定在窗口上。如果PageLayoutContr

ol或MapControl包含大量的数据，在窗口缩放期

间重绘这些数据显得相当重要。为了提高执行效

率，你可以禁止数据重绘直到缩放操作完成后再重

绘之。在缩放时，可以用一个可伸缩的位图来替代

重绘数据。

1.在设计模式显示窗体并从属性窗口中选择axPageLayoutCon

trol1。单击Anchor属性，将axPageLayoutControl1锚定在窗

体的顶、左、底和右部。

2.锚定axMapControl控件到窗体的顶、左和底部。

3.在Form_Load事件的开头增加以下代码：

// 当缩放时禁止重绘

this.SetStyle(ControlStyles.EnableNotifyMessage, true);

4.向类增加以下常量：

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.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_ENTERSIZEMOVE窗口消息。此时，我们禁止在MapControl和PageLayoutControl上绘制图形，而是使用“stretchy bitmap”

绘制。当Windows发送WM_EXITSIZEMOVE消息时，窗体结束缩放，这时我们全部重绘新的范围。

(六) 向ToolbarControl增加命令

ArcGIS Engine提供了120多个命令和工具，

它们与MapControl、PageLayoutControl和Toolbar

Control直接相互协作。这些命令和工具为你提供

了大量的经常使用的地图导航、图形管理、地物选

择等方面的GIS功能。现在将在你的应用程序中

增加这些命令和工具的一部分。

1.在Form_Load事件中的加载文档代码之前添加如下代码。

// 增加打开档命令

string progID;

progID = "esriControlToolsGeneric.ControlsOpenDocCommand ";

axToolbarControl1.AddItem(progID, -1, -1, false, 0,