ArcGIS Engine+C#实例开发教程
版权声明：
《ArcGIS Engine+C#实例开发教程》为 3SDN（http://www.3sdn.net）原创教
程，版权所有。禁止商业用途转载（如需请联系作者），非商业用途转载请注明
出处。教程采用 C#语言，以 VS2005 为开发工具。
读者对象：
ArcGIS Engine（以下简称 AE）开发初学者, 了解 AE 基本体系，了解 C#
基本语法，了解 VS2005 的基本使用方法。
预期学习效果：
进一步理解 AE 的体系结构与开发方法，掌握基本的 GIS 桌面应用程序的
开发。
教程目录：
第一讲 桌面 GIS 应用程序框架的建立
第二讲 菜单的添加及其实现
第三讲 MapControl 与 PageLayoutControl 同步
第四讲 状态栏信息的添加与实现
第五讲 鹰眼的实现
第六讲 右键菜单添加与实现
第七讲 图层符号选择器的实现
第八讲 属性数据表的查询显示
教程 Bug 及优化方案
Made by CrazyDonkey, CSU
第一讲：桌面 GIS 应用程序框架的建立
本讲主要是使用 MapControl、PageLayoutControl、ToolbarControl、TOCControl 四个控件建立起基本的桌面 GIS 应用程序框
架。最终成果预览如下：
1、新建项目
启动 VS2005，选择“文件|新建|项目”，在项目类型中选择 Visual C#，再 选 择 Windows 应用程序模板，输入名称“3sdnMap”，
点击确定。
在解决方案管理器中将“Form1.cs”重命名为“3sdnMap.cs”，在设计视图中，选中窗体，将其属性中的“Text”改为“3sdnMap”。
2、添加控件
选择工具箱中的“菜单和工具栏|MenuStrip”，将其拖入窗体。
选择工具箱中的“ArcGIS Windows Forms”节，将“ToolbarControl”控件拖入窗体，并将其属性中的 Dock 设置为 Top。
选择工具箱中的“菜单和工具栏|StatusStrip”，将其拖入到窗体。
选择工具箱中的“容器|SplitContainer”容器拖入窗体，并将其属性中的 Dock 设置为 Fill。
将 TabControl 控件拖入 Panel1，将 Alignment 属性设置为 Bottom，Dock 属性设置为 Fill。点击 TabPages 属性右边的按钮，
弹出 TabPage 集合编辑器，将 tabPage1 的 Name 设置为 tabPageLayer，Text 设置为图层，将 tabPage2 的 Name 设置为
tabPageProperty，Text 设置为属性。如下所示。
选择“图层”选项卡，拖入 TOCControl 控件，设置 Dock 属性为 Fill。
选择“属性”选项卡，拖入 DataGridView 控件，设置 Dock 属性为 Fill。
拖入 TabControl 控件到 Panel2，设置 Dock 属性为 Fill。并上述类似的方法，将两个选项卡的 Name 和 Text 分别设置为：
（tabPageMap、地图），（tabPageLayout，制版）。
选择“地图”选项卡，拖入 MapControl 控件，设置 Dock 属性为 Fill。
选择“制版”选项卡，拖入 PageLayoutControl 控件，设置 Dock 属性为 Fill。
最后将 LicenseControl 控件拖入到窗体的任意地方。
按 F5 编译运行，可以看到刚才布局好的程序界面了。
3、控件绑定
通过以上步骤添加的控件还只是单独存在，而我们的程序需要各控件间协同工作，因此要进行控件绑定。
分别右击 ToolbarControl、TOCControl 控件，将 Buddy 设置为 axMapControl1，如下图所示。
这样，工具条和图层控件就与地图控件关联了。
4、添加工具
此时，工具条中还没有任何工具，添加的方法也很简单。右击 ToolbarControl，选 择“ 属 性 |Items”，点 击 Add，选 择 Commands
选项卡中的 Generic，双击 Open、SaveAs、Redo、Undo 即可将相应工具添加到工具条。
常见的工具有：
Map Navigation 中的导航工具，Map Inquiry 中的查询工具，Feature Selection 中的选择工具，你可以根据需要酌情添加工具。
5、编译运行
按 F5 即可编译运行程序，至此桌面 GIS 应用程序框架基本框架已经搭建好了，你可以通过工具条的工具打开地图文档，浏
览地图了，效果如开篇所示.
第二讲 菜单的添加及其实现
在上一讲中，我们实现了应用程序基本框架，其中有个小错误，在此先跟大家说明下。在“属性”选项卡中，我们当
时添加的是 DataGridView 控件，这个控件是用来显示数据表的，而专门用于属性的查询和设置的控件是 PropertyGrid 控
件。因此请你删除“属性”选项卡中的 DataGridView 控件，再把位于“工具箱 | 所有 Windows 窗体 |PropertyGrid ”（如
果没有，右击选择“选择项”以添加此控件）控件拖到该选项卡。
在这一讲中，主要讲解菜单的添加和实现。
1、 添加菜单
在设计视图中，单击菜单栏，会出现“请在此处键入”的提示，单击提示就可以键入菜单名称，如“文件”，再单击“文件”，
即可输入其下拉子菜单，如下所示：
Tips ：
每创建一个菜单，请在其属性面板中设置 Name 属性，而且不要为中文，因此 Name 值将是此菜单响应函数的函数名的一
部分，带中文的函数名，总是不好吧。
本讲中，我们将添加新建（ New ）、打开（ Open ）、添加数据（ AddData ）、保存（ Save ）、另存为（ SaveAs ）、退
出（ Exit ）这些菜单，（）内为相应的 Name 属性值。
Tips:
你可以在属性面板中的 Text 属性中，把菜单名设置为中英文形式，如“打开 O pen ”，带下划线的 O 表示此项菜单的快
捷键是字母 O ，设置方法是在相应字母前加上“ & ”字符，如“打开 &Open ”。但这种快捷键只在打开此下拉菜单时才
有效，即当你单击“文件”菜单弹出下拉菜单时，按下字母 O 就可以定位到“打开”菜单。
还有一种在程序运行时都有效的全局快捷键，可以在属性面板中的“ ShortCutKeys ”中设置。
你还可以在属性面板中的 Image 属性中设置你喜欢的菜单图标。单击 Image 那一行右边的按钮，弹出如下菜单。选择“项
目资源文件”，再单击导入就可以选择你的图标了。
最终效果如下所示。
注意，在解决方案面板中，选中刚才添加的所有图标，在其属性面板中将生成操作设置为“嵌入的资源”，这一点很重要！
2、 实现相关菜单
首先定义指针（写在 public partial class Form1 : Form 下面即可）：
private ESRI.ArcGIS.Controls.IMapControl3 m_mapControl = null;
private ESRI.ArcGIS.Controls.IPageLayoutControl2 m_pageLayoutControl = null;
private IMapDocument pMapDocument;
若以上指针无效，请添加以下引用：
using ESRI.ArcGIS.Carto;
using ESRI.ArcGIS.Controls;
using ESRI.ArcGIS.esriSystem;
using ESRI.ArcGIS.Display;
using ESRI.ArcGIS.Geometry;
using ESRI.ArcGIS.SystemUI;
在设计视图中的属性面板中，选择 Form1 ，即主窗体，单击事件按钮（闪电形状的那个按钮），打到“ Load ”事件并双
击，添加此事件。
在 Form1_Load 函数中初始化这些指针：
// 取得 MapControl 和 PageLayoutControl 的引用
m_mapControl = (IMapControl3)this.axMapControl1.Object;
m_pageLayoutControl = (IPageLayoutControl2)this.axPageLayoutControl1.Object;
依次双击每个菜单项，添加菜单响应函数。实现代码如下：
/// <summary>
/// 新建地图命令
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void New_Click(object sender, EventArgs e)
{
// 本命令涉及到 MapControl 和 PageLayoutControl 同步问题，将在下一讲中实现
}
/// <summary>
/// 打开地图文档 Mxd 命令
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void Open_Click(object sender, EventArgs e)
{
// 本命令涉及到 MapControl 和 PageLayoutControl 同步问题，将在下一讲中实现
}
/// <summary>
/// 添加数据命令
