目录
第一讲:桌面 GIS 应用程序框架的建立...............................................................................................1
第二讲 菜单的添加及其实现................................................................................................................ 4
第三讲 MapControl 与 PageLayoutControl 同步...................................................................................8
第四讲 状态栏信息的添加与实现...................................................................................................... 21
第五讲 鹰眼的实现.............................................................................................................................. 24
第六讲 右键菜单添加与实现.............................................................................................................. 29
第七讲 图层符号选择器的实现.......................................................................................................... 35
第八讲 属性数据表的查询显示.......................................................................................................... 52
------------------------------------------------------------------
第一讲:桌面 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;
依次双击每个菜单项,添加菜单响应函数。实现代码如下:
///
/// 新建地图命令
///
///
///
private void New_Click(object sender, EventArgs e)
{
// 本命令涉及到 MapControl 和 PageLayoutControl 同步问题,将在下一讲中实现
}
///
/// 打开地图文档 Mxd 命令
///
///
///
private void Open_Click(object sender, EventArgs e)
{
// 本命令涉及到 MapControl 和 PageLayoutControl 同步问题,将在下一讲中实现
}
///
/// 添加数据命令
///
///
///
private void AddData_Click(object sender, EventArgs e)
{
int currentLayerCount = this.axMapControl1.LayerCount;
ICommand pCommand = new ControlsAddDataCommandClass();
pCommand.OnCreate(this.axMapControl1.Object);
pCommand.OnClick();
}
///
/// 保存地图文档命令
m_pageLayoutControl.DocumentFilename
&&
!=
(null
///
///
///
private void Save_Click(object sender, EventArgs e)
{
// 首先确认当前地图文档是否有效
if
m_mapControl.CheckMxFile(m_pageLayoutControl.DocumentFilename))
{
// 创建一个新的地图文档实例
IMapDocument mapDoc = new MapDocumentClass();
// 打开当前地图文档
mapDoc.Open(m_pageLayoutControl.DocumentFilename, string.Empty);
// 用 PageLayout 中的文档替换当前文档中的 PageLayout 部分
mapDoc.ReplaceContents((IMxdContents)m_pageLayoutControl.PageLayout);
// 保存地图文档
mapDoc.Save(mapDoc.UsesRelativePaths, false);
mapDoc.Close();
}
}
///
/// 另存为地图文档命令
///
///
///
private void SaveAs_Click(object sender, EventArgs e)
{
// 调用另存为命令
ICommand command = new ControlsSaveAsDocCommandClass();
command.OnCreate(m_controlsSynchronizer.ActiveControl);
command.OnClick();
}
///
/// 退出程序
///
///
///
private void Exit_Click(object sender, EventArgs e)
{
Application.Exit();
}
3、 编译运行
按 F5 编译运行程序。也许你会发现,菜单命令的实现方式都是类型的。没错,在 AE9.2 中,内置
了 许 多 常 用 的 Command 和 Tool , 如 ControlsAddDataCommandClass 、
ControlsMapZoomInToolClass 、 ControlsMapPanToolClass 等 等 , 这 些 内 置 对 象 在
ESRI.ArcGIS.Controls 命名空间中,你可以对象浏览器中查看。而且这些内置对象的调用方式都类似,
如下所示:
// 定义
ICommand command = new ControlsSaveAsDocCommandClass();
// 创建
command.OnCreate(m_controlsSynchronizer.ActiveControl);
// 调用
command.OnClick();
第三讲 MapControl 与 PageLayoutControl 同步
在 ArcMap 中,能够很方面地进行 MapView 和 Layout View 两种视图的切换,而且二者之间的数据
是同步显示的。
关于两种视图同步的实现方法有多种,可以使用 ObjectCopy 对象进行数据硬拷贝,而比较简单的方
法莫过于二者共享一份地图了,这也是最常用的方法。
1、新建同步类 ControlsSynchronizer
在解决方案面板中右击项目名,选择“添加|类”,在类别中选择“Visual C#项目项”,在模板中选择
“类”,输入类名“ControlsSynchronizer.cs”,将以下代码覆盖自动生成的代码:
using System;
using System.Drawing;
using System.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
{
///
/// This class is used to synchronize a gven PageLayoutControl and a MapControl.
/// When initialized, the user must pass the reference of these control to the class, bind
/// 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.
/// When alternating between the MapControl and PageLayoutControl, you should activate the 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 members
private IMapControl3 m_mapControl = null;
private IPageLayoutControl2 m_pageLayoutControl = null;
private ITool m_mapActiveTool = null;