第一讲 桌面GIS应用程序框架的建立
第二讲 菜单的添加及其实现
第三讲 MapControl与PageLayoutControl同步
第四讲 状态栏信息的添加与实现
第五讲 鹰眼的实现
第六讲 右键菜单添加与实现
教程Bug及优化方案 1
第七讲 图层符号选择器的实现 1
第七讲 图层符号选择器的实现 2
第八讲 属性数据表的查询显示
第一讲:桌面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();
}
///
/// 保存地图文档命令
///
///
///
private void Save_Click(object sender, EventArgs e)
{
// 首先确认当前地图文档是否有效
if (null != m_pageLayoutControl.DocumentFilename && m_mapControl.Che
ckMxFile(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 等等,这些内置对象在