ArcGISEngine+C#实例开发教程

更新时间:2024-01-10 04:12:01 阅读量: 教育文库 文档下载

说明:文章内容仅供预览,部分内容可能不全。下载后的文档,内容与下面显示的完全一致。下载之前请确认下面内容是否您想要的,是否完整无缺。

《ArcGISEngine+C#实例开发教程》

目 录

第一讲 桌面GIS应用程序框架的建立……………………2 第二讲 菜单的添加及其实现………………………………5 第三讲 MapControl与PageLayoutControl同步……… 9 第四讲 状态栏信息的添加与实现…………………………24 第五讲 鹰眼的实现…………………………………………27 第六讲 右键菜单添加与实现………………………………32 教程Bug及优化方案1…………………………………… 40 第七讲 图层符号选择器的实现1…………………………40 第七讲 图层符号选择器的实现2…………………………57

1

版权声明:

《ArcGISEngine+C#实例开发教程》为3SDN(http://www.3sdn.net)原创教程,版权所有。禁止商业用途转载(如需请联系作者),非商业用途转载请注明出处。教程采用C#语言,以VS2005为开发工具。 读者对象: ArcGISEngine(以下简称AE)开发初学者,了解AE基本体系,了解C#基本语法,了解VS2005的基本使用方法。 预期学习效果:

进一步理解AE的体系结构与开发方法,掌握基本的GIS桌面应用程序的开发

第一讲 桌面GIS应用程序框架的建立

本讲主要是使用MapControl、PageLayoutControl、ToolbarControl、TOCControl四个控件建立起基本的桌面GIS应用程序框架。最终成果预览如下:

1、新建项目

启动VS2005,选择“文件|新建|项目”,在项目类型中选择VisualC#,再选择Windows应用程序模板,输入名称“3sdnMap”,点击确定。

2

在解决方案管理器中将“Form1.cs”重命名为“3sdnMap.cs”,在设计视图中,选中窗体,将其属性中的“Text”改为“3sdnMap”。

2、添加控件

选择工具箱中的“菜单和工具栏|MenuStrip”,将其拖入窗体。

选择工具箱中的“ArcGISWindowsForms”节,将“ToolbarControl”控件拖入窗体,并将其属性中的Dock设置为Top。

选择工具箱中的“菜单和工具栏|StatusStrip”,将其拖入到窗体。

选择工具箱中的“容器|SplitContainer”容器拖入窗体,并将其属性中的Dock设置为Fill。 将TabControl控件拖入Panel1,将Alignment属性设置为Bottom,Dock属性设置为Fill。点击TabPages属性右边的按钮,弹出TabPage集合编辑器,将tabPage1的Name设置为tabPageLayer,Text设置为图层,将tabPage2的Name设置为tabPageProperty,Text设置为属性。如下所示。

3

选择“图层”选项卡,拖入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即可将相应工具添加到工具条

4

常见的工具有:

MapNavigation中的导航工具,MapInquiry中的查询工具,FeatureSelection中的选择工具,你可以根据需要酌情添加工具。 5、编译运行

按F5即可编译运行程序,至此桌面GIS应用程序框架基本框架已经搭建好了,你可以通过工具条的工具打开地图文档,浏览地图了,效果如开篇所示.

第二讲 菜单的添加及其实现

在上一讲中,我们实现了应用程序基本框架,其中有个小错误,在此先跟大家说明下。在“属性”选项卡中,我们当时添加的是DataGridView控件,这个控件是用来显示数据表的,而专门用于属性的查询和设置的控件是PropertyGrid控件。因此请你删除“属性”选项卡中的DataGridView控件,再把位于“工具箱|所有Windows窗体|PropertyGrid”(如果没有,右击选择“选择项”以添加此控件)控件拖到该选项卡。 在这一讲中,主要讲解菜单的添加和实现。

1、添加菜单 在设计视图中,单击菜单栏,会出现“请在此处键入”的提示,单击提示就可以键入菜单名称,如“文件”,再单击“文件”,即可输入其下拉子菜单,如下所示:

5

Tips:

每创建一个菜单,请在其属性面板中设置Name属性,而且不要为中文,因此Name值将是此菜单响应函数的函数名的一部分,带中文的函数名,总是不好吧。 本讲中,我们将添加新建(New)、打开(Open)、添加数据(AddData)、保存(Save)、另存为(SaveAs)、退出(Exit)这些菜单,()内为相应的Name属性值。

Tips:

你可以在属性面板中的Text属性中,把菜单名设置为中英文形式,如“打开Open”,带下划线的O表示此项菜单的快捷键是字母O,设置方法是在相应字母前加上“&”字符,如“打开&Open”。但这种快捷键只在打开此下拉菜单时才有效,即当你单击“文件”菜单弹出下拉菜单时,按下字母O就可以定位到“打开”菜单。

还有一种在程序运行时都有效的全局快捷键,可以在属性面板中的“ShortCutKeys”中设置。 你还可以在属性面板中的Image属性中设置你喜欢的菜单图标。单击Image那一行右边的按钮,弹出如下菜单。选择“项目资源文件”,再单击导入就可以选择你的图标了

最终效果如下所示。

6

注意,在解决方案面板中,选中刚才添加的所有图标,在其属性面板中将生成操作设置为“嵌入的资源”,这一点很重要!

2、实现相关菜单

首先定义指针(写在publicpartialclassForm1:Form下面即可): privateESRI.ArcGIS.Controls.IMapControl3m_mapControl=null;

privateESRI.ArcGIS.Controls.IPageLayoutControl2m_pageLayoutControl=null; privateIMapDocumentpMapDocument; 若以上指针无效,请添加以下引用: usingESRI.ArcGIS.Carto; usingESRI.ArcGIS.Controls; usingESRI.ArcGIS.esriSystem; usingESRI.ArcGIS.Display; usingESRI.ArcGIS.Geometry; usingESRI.ArcGIS.SystemUI; 在设计视图中的属性面板中,选择Form1,即主窗体,单击事件按钮(闪电形状的那个按钮),打到“Load”事件并双击,添加此事件。 在Form1_Load函数中初始化这些指针:

//取得MapControl和PageLayoutControl的引用

m_mapControl=(IMapControl3)this.axMapControl1.Object;

m_pageLayoutControl=(IPageLayoutControl2)this.axPageLayoutControl1.Object; 依次双击每个菜单项,添加菜单响应函数。实现代码如下: ///

///新建地图命令 ///

///

privatevoidNew_Click(objectsender,EventArgse) {

//本命令涉及到MapControl和PageLayoutControl同步问题,将在下一讲中实现 }

7

///

///打开地图文档Mxd命令 ///

///

privatevoidOpen_Click(objectsender,EventArgse) {

//本命令涉及到MapControl和PageLayoutControl同步问题,将在下一讲中实现 }

///

///添加数据命令 ///

///

privatevoidAddData_Click(objectsender,EventArgse) {

intcurrentLayerCount=this.axMapControl1.LayerCount;

ICommandpCommand=newControlsAddDataCommandClass(); pCommand.OnCreate(this.axMapControl1.Object); pCommand.OnClick(); }

///

///保存地图文档命令 ///

///

privatevoidSave_Click(objectsender,EventArgse) {

//首先确认当前地图文档是否有效

if(null!=m_pageLayoutControl.DocumentFilename&&m_mapControl.CheckMxFile(m_pageLayoutControl.DocumentFilename)) {

//创建一个新的地图文档实例

IMapDocumentmapDoc=newMapDocumentClass(); //打开当前地图文档

mapDoc.Open(m_pageLayoutControl.DocumentFilename,string.Empty); //用PageLayout中的文档替换当前文档中的PageLayout部分

mapDoc.ReplaceContents((IMxdContents)m_pageLayoutControl.PageLayout); //保存地图文档

mapDoc.Save(mapDoc.UsesRelativePaths,false); mapDoc.Close(); } }

///

8

///另存为地图文档命令 ///

///

privatevoidSaveAs_Click(objectsender,EventArgse) {

//调用另存为命令

ICommandcommand=newControlsSaveAsDocCommandClass(); command.OnCreate(m_controlsSynchronizer.ActiveControl); command.OnClick(); }

///

///退出程序 ///

///

privatevoidExit_Click(objectsender,EventArgse) {

Application.Exit(); }

3、编译运行

按F5编译运行程序。也许你会发现,菜单命令的实现方式都是类型的。没错,在AE9.2中,内置了许多常用的Command和Tool,如ControlsAddDataCommandClass、ControlsMapZoomInToolClass、ControlsMapPanToolClass等等,这些内置对象在ESRI.ArcGIS.Controls命名空间中,你可以对象浏览器中查看。而且这些内置对象的调用方式都类似,如下所示: //定义

ICommandcommand=newControlsSaveAsDocCommandClass(); //创建

command.OnCreate(m_controlsSynchronizer.ActiveControl); //调用

command.OnClick();

希望你可以举一反三,去实现更多的你想要的功能。

第三讲 MapControl与PageLayoutControl同步

在ArcMap中,能够很方面地进行MapView和LayoutView两种视图的切换,而且二者之间的数据是同步显示的。

关于两种视图同步的实现方法有多种,可以使用ObjectCopy对象进行数据硬拷贝,而比较简单的方法莫过于二者共享一份地图了,这也是最常用的方法。

9

1、新建同步类ControlsSynchronizer

在解决方案面板中右击项目名,选择“添加|类”,在类别中选择“VisualC#项目项”,在模板中选择“类”,输入类名“ControlsSynchronizer.cs”,将以下代码覆盖自动生成的代码:

usingSystem;

usingSystem.Drawing; usingSystem.Collections;

usingSystem.ComponentModel; usingSystem.Windows.Forms; usingSystem.IO;

usingSystem.Runtime.InteropServices; usingESRI.ArcGIS.esriSystem; usingESRI.ArcGIS.Carto; usingESRI.ArcGIS.Controls; usingESRI.ArcGIS.SystemUI; namespace_sdnMap {

///

///ThisclassisusedtosynchronizeagvenPageLayoutControlandaMapControl. ///Wheninitialized,theusermustpassthereferenceofthesecontroltotheclass,bind

///thecontroltogetherbycalling'BindControls'whichinturnsetsajoinedMapreferenced ///bybothcontrol;andsetallthebuddycontrolsjoinedbetweenthesetwocontrols.

///WhenalternatingbetweentheMapControlandPageLayoutControl,youshouldactivatethevisiblecontrol

///anddeactivatetheotherbycallingActivateXXX.

///Thiscalssislimitedtoasituationwherethecontrolsarenotsimultaneouslyvisible. ///

publicclassControlsSynchronizer {

#regionclassmembers

privateIMapControl3m_mapControl=null;

privateIPageLayoutControl2m_pageLayoutControl=null; privateIToolm_mapActiveTool=null;

privateIToolm_pageLayoutActiveTool=null; privateboolm_IsMapCtrlactive=true;

privateArrayListm_frameworkControls=null; #endregion

#regionconstructor ///

///默认构造函数 ///

publicControlsSynchronizer()

10

{

//初始化ArrayList

m_frameworkControls=newArrayList(); }

///

///构造函数 ///

///

///

publicControlsSynchronizer(IMapControl3mapControl,IPageLayoutControl2pageLayoutControl) :this() {

//为类成员赋值

m_mapControl=mapControl;

m_pageLayoutControl=pageLayoutControl; }

#endregion

#regionproperties ///

///取得或设置MapControl ///

publicIMapControl3MapControl {

get{returnm_mapControl;} set{m_mapControl=value;} }

///

///取得或设置PageLayoutControl ///

publicIPageLayoutControl2PageLayoutControl {

get{returnm_pageLayoutControl;} set{m_pageLayoutControl=value;} }

///

///取得当前ActiveView的类型 ///

publicstringActiveViewType { get {

if(m_IsMapCtrlactive) return\else

11

return\} }

///

///取得当前活动的Control ///

publicobjectActiveControl { get {

if(m_mapControl==null||m_pageLayoutControl==null)

thrownewException(\ontrolarenotinitialized!\if(m_IsMapCtrlactive)

returnm_mapControl.Object; else

returnm_pageLayoutControl.Object; } }

#endregion

#regionMethods ///

///激活MapControl并解除thePagleLayoutControl ///

publicvoidActivateMap() { try {

if(m_pageLayoutControl==null||m_mapControl==null)

thrownewException(\ntrolarenotinitialized!\

//缓存当前PageLayout的CurrentTool

if(m_pageLayoutControl.CurrentTool!=null)m_pageLayoutActiveTool=m_pageLayoutControl.CurrentTool;

//解除PagleLayout

m_pageLayoutControl.ActiveView.Deactivate(); //激活MapControl

m_mapControl.ActiveView.Activate(m_mapControl.hWnd);

//将之前MapControl最后使用的tool,作为活动的tool,赋给MapControl的CurrentTool if(m_mapActiveTool!=null)m_mapControl.CurrentTool=m_mapActiveTool; m_IsMapCtrlactive=true;

//为每一个的frameworkcontrols,设置Buddycontrol为MapControl this.SetBuddies(m_mapControl.Object); }

12

catch(Exceptionex) {

thrownewException(string.Format(\} }

///

///激活PagleLayoutControl并减活MapCotrol ///

publicvoidActivatePageLayout() { try {

if(m_pageLayoutControl==null||m_mapControl==null)

thrownewException(\youtControlarenotinitialized!\

//缓存当前MapControl的CurrentTool

if(m_mapControl.CurrentTool!=null)m_mapActiveTool=m_mapControl.CurrentTool; //解除MapControl

m_mapControl.ActiveView.Deactivate(); //激活PageLayoutControl

m_pageLayoutControl.ActiveView.Activate(m_pageLayoutControl.hWnd);

//将之前PageLayoutControl最后使用的tool,作为活动的tool,赋给PageLayoutControl的CurrentTool

if(m_pageLayoutActiveTool!=null)m_pageLayoutControl.CurrentTool=m_pageLayoutActiveTool;

m_IsMapCtrlactive=false;

//为每一个的frameworkcontrols,设置Buddycontrol为PageLayoutControl this.SetBuddies(m_pageLayoutControl.Object); }

catch(Exceptionex) {

thrownewException(string.Format(\age)); } }

///

///给予一个地图,置换PageLayoutControl和MapControl的focusmap ///

///

if(newMap==null)

thrownewException(\

13

ed!\

if(m_pageLayoutControl==null||m_mapControl==null)

thrownewException(\trolarenotinitialized!\

//createanewinstanceofIMapscollectionwhichisneededbythePageLayout //创建一个PageLayout需要用到的,新的IMapscollection的实例 IMapsmaps=newMaps();

//addthenewmaptotheMapscollection

//把新的地图加到Mapscollection里头去 maps.Add(newMap);

boolbIsMapActive=m_IsMapCtrlactive;

//callreplacemaponthePageLayoutinordertoreplacethefocusmap

//wemustcallActivatePageLayout,sinceitisthecontrolwecall'ReplaceMaps' //调用PageLayout的replacemap来置换focusmap

//我们必须调用ActivatePageLayout,因为它是那个我们可以调用\的Control this.ActivatePageLayout();

m_pageLayoutControl.PageLayout.ReplaceMaps(maps); //assignthenewmaptotheMapControl //把新的地图赋给MapControl m_mapControl.Map=newMap; //resettheactivetools //重设activetools

m_pageLayoutActiveTool=null; m_mapActiveTool=null;

//makesurethatthelastactivecontrolisactivated //确认之前活动的control被激活 if(bIsMapActive) {

this.ActivateMap();

m_mapControl.ActiveView.Refresh(); } else {

this.ActivatePageLayout();

m_pageLayoutControl.ActiveView.Refresh(); } }

///

///bindtheMapControlandPageLayoutControltogetherbyassigninganewjointfocusmap ///指定共同的Map来把MapControl和PageLayoutControl绑在一起 ///

///

///

///

14

MapControl被首先激活,则为true

publicvoidBindControls(IMapControl3mapControl,IPageLayoutControl2pageLayoutControl,boolactivateMapFirst) {

if(mapControl==null||pageLayoutControl==null)

thrownewException(\ntrolarenotinitialized!\

m_mapControl=MapControl;

m_pageLayoutControl=pageLayoutControl; this.BindControls(activateMapFirst); }

///

///bindtheMapControlandPageLayoutControltogetherbyassigninganewjointfocusmap ///指定共同的Map来把MapControl和PageLayoutControl绑在一起 ///

/// publicvoidBindControls(boolactivateMapFirst) {

if(m_pageLayoutControl==null||m_mapControl==null)

thrownewException(\ntrolarenotinitialized!\

//createanewinstanceofIMap //创造IMap的一个实例

IMapnewMap=newMapClass(); newMap.Name=\

//createanewinstanceofIMapscollectionwhichisneededbythePageLayout //创造一个新的IMapscollection的实例,这是PageLayout所需要的 IMapsmaps=newMaps();

//addthenewMapinstancetotheMapscollection //把新的Map实例赋给Mapscollection maps.Add(newMap);

//callreplacemaponthePageLayoutinordertoreplacethefocusmap //调用PageLayout的replacemap来置换focusmap m_pageLayoutControl.PageLayout.ReplaceMaps(maps); //assignthenewmaptotheMapControl //把新的map赋给MapControl m_mapControl.Map=newMap; //resettheactivetools //重设activetools

m_pageLayoutActiveTool=null; m_mapActiveTool=null;

//makesurethatthelastactivecontrolisactivated

15

//确定最后活动的control被激活 if(activateMapFirst) this.ActivateMap(); else

this.ActivatePageLayout(); }

///

///bypassingtheapplication'stoolbarsandTOCtothesynchronizationclass,itsavesyouthe

///managementofthebuddycontroleachtimetheactivecontrolchanges.Thismethodadstheframework ///controltoanarray;oncetheactivecontrolchanges,theclassiteratesthroughthearrayand ///callesSetBuddyControloneachofthestoredframeworkcontrol. ///

///

publicvoidAddFrameworkControl(objectcontrol) {

if(control==null)

thrownewException(\zed!\

m_frameworkControls.Add(control); }

///

///Removeaframeworkcontrolfromthemanagedlistofcontrols ///

///

publicvoidRemoveFrameworkControl(objectcontrol) {

if(control==null)

thrownewException(\snotinitialized!\

m_frameworkControls.Remove(control); }

///

///Removeaframeworkcontrolfromthemanagedlistofcontrolsbyspecifyingitsindexinthelist ///

///

publicvoidRemoveFrameworkControlAt(intindex) {

if(m_frameworkControls.Count

thrownewException(\\

m_frameworkControls.RemoveAt(index); }

///

///whentheactivecontrolchanges,theclassiteratesthroughthearrayoftheframeworkcontrols

16

///andcallesSetBuddyControloneachofthecontrols. ///

///

if(buddy==null)

thrownewException(\);

foreach(objectobjinm_frameworkControls) {

if(objisIToolbarControl) {

((IToolbarControl)obj).SetBuddyControl(buddy); }

elseif(objisITOCControl) {

((ITOCControl)obj).SetBuddyControl(buddy); } } }

catch(Exceptionex) {

thrownewException(string.Format(\} }

#endregion } }

2、新建Maps类

在同步类中,要用到Maps类,用于管理地图对象。与新建同步类ControlsSynchronizer类似,我们新建一Maps类,其所有代码如下所示:

usingSystem;

usingSystem.Collections;

usingSystem.Collections.Generic; usingSystem.Text;

usingSystem.Runtime.InteropServices; usingESRI.ArcGIS.Carto; namespace_sdnMap {

17

[Guid(\[ClassInterface(ClassInterfaceType.None)] [ProgId(\

publicclassMaps:IMaps,IDisposable {

//classmember-usinginternallyanArrayListtomanagetheMapscollection privateArrayListm_array=null; #regionclassconstructor publicMaps() {

m_array=newArrayList(); }

#endregion

#regionIDisposableMembers ///

///Disposethecollection ///

publicvoidDispose() {

if(m_array!=null) {

m_array.Clear(); m_array=null; } }

#endregion

#regionIMapsMembers ///

///RemovetheMapatthegivenindex ///

///

if(Index>m_array.Count||Index<0)

thrownewException(\m_array.RemoveAt(Index); }

///

///ResettheMapsarray ///

publicvoidReset() {

m_array.Clear(); }

18

///

///GetthenumberofMapsinthecollection ///

publicintCount { get {

returnm_array.Count; } }

///

///ReturntheMapatthegivenindex ///

///

publicIMapget_Item(intIndex) {

if(Index>m_array.Count||Index<0)

thrownewException(\returnm_array[Index]asIMap; }

///

///RemovetheinstanceofthegivenMap ///

///

m_array.Remove(Map); }

///

///CreateanewMap,addittothecollectionandreturnittothecaller ///

/// publicIMapCreate() {

IMapnewMap=newMapClass(); m_array.Add(newMap); returnnewMap; }

///

///AddthegivenMaptothecollection ///

///

19

{

if(Map==null)

thrownewException(\m_array.Add(Map); }

#endregion } }

3、新建打开文档类OpenNewMapDocument

由于从工具栏自带的打开按钮打开地图文档的时候,不会自动进行两种视图之间的同步,所以我们要自己派生一个OpenNewMapDocument类,用于打开地图文档。

右击项目名,选择“添加|类”,再选择ArcGIS类别中的BaseCommand模板,输入类名为“OpenNewMapDocument.cs”。 首先添加引用:

usingSystem.Windows.Forms; usingESRI.ArcGIS.Carto; 再添加如下成员变量:

privateControlsSynchronizerm_controlsSynchronizer=null; 修改默认的构造函数如下所示: //添加参数

publicOpenNewMapDocument(ControlsSynchronizercontrolsSynchronizer) { //

//TODO:Definevaluesforthepublicproperties //

//设定相关属性值

base.m_category=\base.m_caption=\

base.m_message=\base.m_toolTip=\

base.m_name=\//初始化m_controlsSynchronizer

m_controlsSynchronizer=controlsSynchronizer; try { //

//TODO:changebitmapnameifnecessary //

stringbitmapResourceName=GetType().Name+\

base.m_bitmap=newBitmap(GetType(),bitmapResourceName); }

20

catch(Exceptionex) {

System.Diagnostics.Trace.WriteLine(ex.Message,\} }

再在OnClick函数中添加如下代码:

publicoverridevoidOnClick() {

//TODO:AddOpenNewMapDocument.OnClickimplementation OpenFileDialogdlg=newOpenFileDialog(); dlg.Filter=\dlg.Multiselect=false;

dlg.Title=\

if(dlg.ShowDialog()==DialogResult.OK) {

stringdocName=dlg.FileName;

IMapDocumentmapDoc=newMapDocumentClass();

if(mapDoc.get_IsPresent(docName)&&!mapDoc.get_IsPasswordProtected(docName)) {

mapDoc.Open(docName,string.Empty); IMapmap=mapDoc.get_Map(0);

m_controlsSynchronizer.ReplaceMap(map); mapDoc.Close(); } } }

在添加类时,模板会自动添加一个名为“OpenNewMapDocument.bmp”的图标,你可以自己修改或者替换为打开的文件夹的图标

4、两种视图的同步

在3sdnMap.cs中添加成员变量,即同步类对象:

privateControlsSynchronizerm_controlsSynchronizer=null; 在Form1_Load函数中进行初始化工作:

//初始化controlssynchronizationcalss m_controlsSynchronizer=new

ControlsSynchronizer(m_mapControl,m_pageLayoutControl);

//把MapControl和PageLayoutControl绑定起来(两个都指向同一个Map),然后设置MapControl为活动的Control

m_controlsSynchronizer.BindControls(true);

21

//为了在切换MapControl和PageLayoutControl视图同步,要添加FrameworkControl m_controlsSynchronizer.AddFrameworkControl(axToolbarControl1.Object); m_controlsSynchronizer.AddFrameworkControl(this.axTOCControl1.Object); //添加打开命令按钮到工具条

OpenNewMapDocumentopenMapDoc=newOpenNewMapDocument(m_controlsSynchronizer); axToolbarControl1.AddItem(openMapDoc,-1,0,false,-1,esriCommandStyles.esriCommandStyleIconOnly);

因为我们自动派生了打开文档类,并自己将其添加到工具条,所以我们就不需要工具条原来的“打开”按钮了,可以ToolbarControl的属性中将其删除。 下面,我们可完成上一讲遗留的功能了。

///

///新建地图命令 ///

///

privatevoidNew_Click(objectsender,EventArgse) {

//询问是否保存当前地图

DialogResultres=MessageBox.Show(\是否保存当前地\if(res==DialogResult.Yes) {

//如果要保存,调用另存为对话框

ICommandcommand=newControlsSaveAsDocCommandClass(); if(m_mapControl!=null)

command.OnCreate(m_controlsSynchronizer.MapControl.Object); else

command.OnCreate(m_controlsSynchronizer.PageLayoutControl.Object); command.OnClick(); }

//创建新的地图实例

IMapmap=newMapClass(); map.Name=\

m_controlsSynchronizer.MapControl.DocumentFilename=string.Empty; //更新新建地图实例的共享地图文档

m_controlsSynchronizer.ReplaceMap(map); }

///

///打开地图文档Mxd命令 ///

///

privatevoidOpen_Click(objectsender,EventArgse)

22

?\提示图

{

if(this.axMapControl1.LayerCount>0) {

DialogResultresult=MessageBox.Show(\是否保存当前地图?\警告\MessageBoxButtons.YesNoCancel,MessageBoxIcon.Question); if(result==DialogResult.Cancel)return;

if(result==DialogResult.Yes)this.Save_Click(null,null); }

OpenNewMapDocumentopenMapDoc=

newOpenNewMapDocument(m_controlsSynchronizer);

openMapDoc.OnCreate(m_controlsSynchronizer.MapControl.Object); openMapDoc.OnClick(); }

在添加数据AddData时,我们也要进行地图共享,故在AddData_Click函数后面添加如下代码:

IMappMap=this.axMapControl1.Map;

this.m_controlsSynchronizer.ReplaceMap(pMap);

在另存为地图文档时,有可能会丢失数据,因此我们需要提示用户以确认操作,故需修改SaveAs_Click函数,如下所示: ///

///另存为地图文档命令 ///

///

privatevoidSaveAs_Click(objectsender,EventArgse) {

//如果当前视图为MapControl时,提示用户另存为操作将丢失PageLayoutControl中的设置 if(m_controlsSynchronizer.ActiveControlisIMapControl3) {

if(MessageBox.Show(\另存为地图文档将丢失制版视图的设置\\r\\n您要继续吗?\提示\return; }

//调用另存为命令

ICommandcommand=newControlsSaveAsDocCommandClass(); command.OnCreate(m_controlsSynchronizer.ActiveControl); command.OnClick(); }

在切换视图时,我们要激活相关的视图,故在设计视图的属性面板中选择tabControl2控件,再选择事件按钮,找到“SelectedIndexChanged”事件双击添加之。其实现代码如下所示:

///

23

///切换地图和制版视图 ///

///

privatevoidtabControl2_SelectedIndexChanged(objectsender,EventArgse) {

if(this.tabControl2.SelectedIndex==0) {

//激活MapControl

m_controlsSynchronizer.ActivateMap(); } else {

//激活PageLayoutControl

m_controlsSynchronizer.ActivatePageLayout(); } }

5、编译运行

按F5编译运行程序,至此我们完成了MapControl和PageLayoutControl两种视图的同步工

第四讲 状态栏信息的添加与实现

在上一讲中,我们完成了MapControl和PageLayoutControl两种视图的同步工作,本讲我们将完成状态栏信息的添加与实现。

应用程序的状态栏一般用来显示程序的当前状态,当前所使用的工具。GIS应用程序一般也在状态栏显示当前光标的坐标、比例尺等信息。

学习完本讲内容,您将学会状态栏编程的基本方法,并且能够在我们的程序的状态栏中添加且显示以下信息: 当前所用工具信息 当前比例尺 当前坐标

1、添加状态栏项目

在设计视图中,点击窗体中的状态栏,在其属性面板中找到“Items”项,单击其右边的按钮,在下拉框中选择“StatusLabel”,单击“添加按钮”,依次添加四个StatusLabel,依次修改属性参数如下表所示:

24

设置好之后如下图所示:

Tips:

我们设计出的状态栏最终如下所示:

Spring属性表示可以按状态栏剩余空间自动伸缩。所以加入Blank项目,只是为了占个位子,以达到ScaleLabel和CoordinateLabel项目右对齐而MessageLabel项目左对齐的目的。

2、显示当前所用工具信息

首先添加axToolbarControl1的OnMouseMove事件(相信大家看了以上的教程,已经知道怎么添加事件了吧,还不知道的建议再温习下前几讲的内容)。在其事件响应函数代码如下: privatevoidaxToolbarControl1_OnMouseMove(objectsender,IToolbarControlEvents_OnMouseMoveEvente) {

25

//取得鼠标所在工具的索引号

intindex=axToolbarControl1.HitTest(e.x,e.y,false); if(index!=-1) {

//取得鼠标所在工具的ToolbarItem

IToolbarItemtoolbarItem=axToolbarControl1.GetItem(index); //设置状态栏信息

MessageLabel.Text=toolbarItem.Command.Message; } else {

MessageLabel.Text=\就绪\} }

3、显示当前比例尺

添加axMapControl1的OnMouseMove事件,其代码如下:

privatevoidaxMapControl1_OnMouseMove(objectsender,IMapControlEvents2_OnMouseMoveEvente) {

//显示当前比例尺

ScaleLabel.Text=\比例尺1:\}

4、显示当前坐标

显示当前坐标也是axMapControl1的OnMouseMove事件中响应,故只要在axMapControl1_OnMouseMove函数中添加如下代码即可: //显示当前坐标

CoordinateLabel.Text=\当前坐标X=\.ToString()+\

按F5编译运行,可以看到,我们的程序已经能够正常工作了。但是细心的你可能会发现,当前坐标的后面的坐标单位为“esriUnknownUnits”或“esriMeters”之类,即系统在正常单位的前面加上了“esri”,追求完美的我们自然看得不舒服。那就进行简单的替换吧。 首先定义个全局坐标单位变量sMapUnits,如下所示: privatestringsMapUnits;

再Form1_Load函数中进行初始化: sMapUnits=\

添加axMapControl1控件的OnMapReplaced事件,在事件响应函数中进行坐标单位替换,代码如下:

privatevoidaxMapControl1_OnMapReplaced(objectsender,IMapControlEvents2_OnMapReplacedEvente) {

esriUnitsmapUnits=axMapControl1.MapUnits; switch(mapUnits)

26

{

caseesriUnits.esriCentimeters: sMapUnits=\break;

caseesriUnits.esriDecimalDegrees: sMapUnits=\break;

caseesriUnits.esriDecimeters: sMapUnits=\break;

caseesriUnits.esriFeet: sMapUnits=\break;

caseesriUnits.esriInches: sMapUnits=\break

caseesriUnits.esriKilometers: sMapUnits=\break;

caseesriUnits.esriMeters: sMapUnits=\break;

caseesriUnits.esriMiles: sMapUnits=\break;

caseesriUnits.esriMillimeters: sMapUnits=\break;

caseesriUnits.esriNauticalMiles: sMapUnits=\break;

caseesriUnits.esriPoints: sMapUnits=\break;

caseesriUnits.esriUnknownUnits: sMapUnits=\break;

caseesriUnits.esriYards: sMapUnits=\break; } }

5、编译运行

27

按F5编译运行程序。如果你足够细心的话,相信你已经成功了!

在本讲中,介绍中StatusStrip控件的基本使用方法和AE中当所用工具信息、当前比例尺和当前坐标的显示调用方法。

第五讲 鹰眼的实现

在上一讲中,我们实现了状态栏的相关信息显示,在这一讲中我们将要实现鹰眼功能。 所谓的鹰眼,就是一个缩略地图,上面有一个矩形框,矩形框区域就是当前显示的地图区域,拖动矩形框可以改变当前地图显示的位置,改变矩形框的大小,可以改变当前地图的显示区域大小,从起到导航的作用。鹰眼是地图浏览中常用的功能之一。

关于鹰眼的实现方式,最常用的是用一个MapControl控件显示地图全图,并在上面画一个红色矩形框表示当前地图的显示范围,并实现鹰眼MapControl与主窗体的MapControl互动。本讲最终效果如下所示:

图1鹰眼效果

1、添加鹰眼控件

由于本教程在第一讲中没有预先考虑到鹰眼所放的位置,故我们要先稍微调整一下程序框架,并添加一个MapControl用于显示鹰眼。

在本教程中,我们将鹰眼放在图层控件的下方,调整方法如下:

28

(1)在设计视图中,选择tabControl1控件,即放图层和属性的那个容器,将其Dock属性设为None,并用鼠标拖拽将其缩小。把工具箱中的SplitContainer控件拖到窗体的左窗格,即放在tabControl1控件的旁边。并将其Orientation属性设置为Horizontal。

(2)选中tabControl1控件,按Ctrl+X剪切,再选中刚才粘贴到SplitContainer2的Panel1中,如图2所示。操作完成后效果如图3所示。

图2 图3

(3)再选中SplitContainer2控件(如果不好选中,直接以属性面板中选择SplitContainer2),将其Dock属性设置为Fill。再选中tabControl1,将其Dock属性也设置为Fill。

(4)从工具箱中选择MapControl控件并拖到SplitContainer2的Panel2,作为鹰眼控件。最终效果如图4所示。

29

图4

2、鹰眼的实现

(1)载入地图到鹰眼控件

当地图载入到主Map控件时,同时也载入到鹰眼控件,在axMapControl1_OnMapReplaced事件响应函数(此函数上一讲中已经添加了)中添加如下代码:

privatevoidaxMapControl1_OnMapReplaced(objectsender,IMapControlEvents2_OnMapReplacedEvente) {

//前面代码省略

//当主地图显示控件的地图更换时,鹰眼中的地图也跟随更换 this.axMapControl2.Map=newMapClass();

//添加主地图控件中的所有图层到鹰眼控件中 for(inti=1;i<=this.axMapControl1.LayerCount;i++) {

this.axMapControl2.AddLayer(this.axMapControl1.get_Layer(this.axMapControl1.LayerCount-i)); }

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

this.axMapControl2.Extent=this.axMapControl1.FullExtent; //刷新鹰眼控件地图

this.axMapControl2.Refresh(); }

(2)绘制鹰眼矩形框

为鹰眼控件MapControl1添加OnExtentUpdated事件,此事件是在主Map控件的显示范围改变时响应,从而相应更新鹰眼控件中的矩形框。其响应函数代码如下:

privatevoidaxMapControl1_OnExtentUpdated(objectsender,IMapControlEvents2_OnExtentUpdatedEvente) {

//得到新范围

IEnvelopepEnv=(IEnvelope)e.newEnvelope;

IGraphicsContainerpGra=axMapControl2.MapasIGraphicsContainer; IActiveViewpAv=pGraasIActiveView;

//在绘制前,清除axMapControl2中的任何图形元素 pGra.DeleteAllElements();

IRectangleElementpRectangleEle=newRectangleElementClass(); IElementpEle=pRectangleEleasIElement; pEle.Geometry=pEnv; //设置鹰眼图中的红线框

IRgbColorpColor=newRgbColorClass(); pColor.Red=255; pColor.Green=0; pColor.Blue=0;

30

pColor.Transparency=255; //产生一个线符号对象

ILineSymbolpOutline=newSimpleLineSymbolClass(); pOutline.Width=2;

pOutline.Color=pColor; //设置颜色属性

pColor=newRgbColorClass(); pColor.Red=255; pColor.Green=0; pColor.Blue=0;

pColor.Transparency=0; //设置填充符号的属性

IFillSymbolpFillSymbol=newSimpleFillSymbolClass(); pFillSymbol.Color=pColor; pFillSymbol.Outline=pOutline;

IFillShapeElementpFillShapeEle=pEleasIFillShapeElement; pFillShapeEle.Symbol=pFillSymbol;

pGra.AddElement((IElement)pFillShapeEle,0); //刷新

pAv.PartialRefresh(esriViewDrawPhase.esriViewGraphics,null,null); }

(3)鹰眼与主Map控件互动

为鹰眼控件MapControl2添加OnMouseDown事件,代码如下:

privatevoidaxMapControl2_OnMouseDown(objectsender,IMapControlEvents2_OnMouseDownEvente) {

if(this.axMapControl2.Map.LayerCount!=0) {

//按下鼠标左键移动矩形框 if(e.button==1) {

IPointpPoint=newPointClass();

pPoint.PutCoords(e.mapX,e.mapY);

IEnvelopepEnvelope=this.axMapControl1.Extent; pEnvelope.CenterAt(pPoint);

this.axMapControl1.Extent=pEnvelope;

this.axMapControl1.ActiveView.PartialRefresh(esriViewDrawPhase.esriViewGeography,null,null; }

//按下鼠标右键绘制矩形框 elseif(e.button==2) {

IEnvelopepEnvelop=this.axMapControl2.TrackRectangle(); this.axMapControl1.Extent=pEnvelop;

this.axMapControl1.ActiveView.PartialRefresh(esriViewDrawPhase.esriViewGeography,null,null)

31

; } } }

为鹰眼控件MapControl2添加OnMouseMove事件,主要实现按下鼠标左键的时候移动矩形框,同时也改变主的图控件的显示范围。代码如下:

privatevoidaxMapControl2_OnMouseMove(objectsender,IMapControlEvents2_OnMouseMoveEvente) {

//如果不是左键按下就直接返回 if(e.button!=1)return

IPointpPoint=newPointClass();

pPoint.PutCoords(e.mapX,e.mapY); his.axMapControl1.CenterAt(pPoint);

this.axMapControl1.ActiveView.PartialRefresh(esriViewDrawPhase.esriViewGeography,null,null);}

3、编译运行

按F5编译运行程序。

期待的鹰眼功能你已经实现了,按下左键在鹰眼窗口中移动,或者按下右键在鹰眼窗口中画一个矩形,主地图窗口的显示范围都会跟着变化。主地图窗口中的地图经放大缩小等操作后,鹰眼窗口的矩形框大小也会随着改变。

第六讲 右键菜单添加与实现

在上一讲中,我们完成了鹰眼功能,在这一讲中,大家将实现TOCControl控件和主地图控件的右键菜单。 在AE开发中,右键菜单有两种实现方式,一是使用VS2005自带的ContextMenuStrip控件,二是用AE封装的IToolbarMenu接口。相比较而言,后者更为简单实用,本文采用后者的实现方法。

1、创建右键菜单

在Form1类里面添加如下变量的定义:

32

2、添加菜单项

第1步中创建的菜单可认为是菜单容器,里面什么都没有,具体的命令或工具作为菜单项添加到菜单容器才能工作。一般情况下,启动程序就要完成菜单项的添加,故此工作在Form1_Load函数完成。

当然,添加菜单项之前,必须实现相应命令或工具。这里的命令或工具可以AE内置的也可以是自定义的。AE内置了许多可以直接调用的常用命令和工具,如ControlsAddDataCommandClass,在ESRI.ArcGIS.Controls命名空间中,大家可以对象浏览器中查看。当然,这里也可以直接调用AE内置的菜单,如ControlsFeatureSelectionMenu。另外,本讲也实现三自定义命令,以做示范。它们分别为图层可视控制命令(用于控制图层显示与否)、移除图层和放大到整个图层命令。实现方法也很简单,就是右击3sdnMap项目,选择“添加|类”,选择C#普通的类模板,用以下代码覆盖系统自己生成的所有代码。 图层可视控制类LayerVisibility代码:

33

34

35

36

37

//以二级菜单的形式添加内置的“地图浏览”菜单

m_menuMap.AddSubMenu(\//添加自定义菜单项到TOCCOntrol的图层菜单中 m_menuLayer=newToolbarMenuClass(); //添加“移除图层”菜单项

m_menuLayer.AddItem(newRemoveLayer(),-1,0,false,esriCommandStyles.esriCommandStyleTextOnly);

//添加“放大到整个图层”菜单项

m_menuLayer.AddItem(newZoomToLayer(),-1,1,true,esriCommandStyles.esriCommandStyleTextOnly);

//设置菜单的Hook

38

m_menuLayer.SetHook(m_mapControl); m_menuMap.SetHook(m_mapControl); 3、

弹出右键菜单

顾名思义,右键菜单是在鼠标右键按下的时候弹出,所以我们要添加TOCControl1控件的OnMouseDown事件,实现代码如下:

privatevoidaxTOCControl1_OnMouseDown(objectsender,ITOCControlEvents_OnMouseDownEvente) {

//如果不是右键按下直接返回 if(e.button!=2)return;

esriTOCControlItemitem=esriTOCControlItem.esriTOCControlItemNone; IBasicMapmap=null; ILayerlayer=null; objectother=null; objectindex=null; //判断所选菜单的类型

m_tocControl.HitTest(e.x,e.y,refitem,refmap,reflayer,refother,refindex); //确定选定的菜单类型,Map或是图层菜单

if(item==esriTOCControlItem.esriTOCControlItemMap) m_tocControl.SelectItem(map,null); else

m_tocControl.SelectItem(layer,null);

//设置CustomProperty为layer(用于自定义的Layer命令) m_mapControl.CustomProperty=layer; //弹出右键菜单

if(item==esriTOCControlItem.esriTOCControlItemMap) m_menuMap.PopupMenu(e.x,e.y,m_tocControl.hWnd); if(item==esriTOCControlItem.esriTOCControlItemLayer) m_menuLayer.PopupMenu(e.x,e.y,m_tocControl.hWnd); }

同样的方法,我们也可以实现主地图控件的右键菜单,以方便地图浏览。添加MapControl1控件的OnMouseDown事件,实现代码如下: ///

///主地图控件的右键响应函数 ///

///

PrivatevoidaxMapControl1_OnMouseDown(objectsender,IMapControlEvents2_OnMouseDownEvente) {

if(e.button==2) {

39

//弹出右键菜单

m_menuMap.PopupMenu(e.x,e.y,m_mapControl.hWnd); } }

4、编译运行

按F5编译运行程序,你会发现,原来右键菜单实现起来是这么的简单啊!

教程Bug及优化方案1

到第六讲为止已经发现的教程Bug及解决方法如下:

1、在第二讲可能会出现变量未定义。

原因:第二讲与第三讲联系紧密,我为控制篇幅才将其分为两讲,某些变量是在第三讲才进行定义,请大家注意。

2、第六讲弹不出TOCControl的右键菜单

原因:没有取得m_tocControl的指针,即没有把m_tocControl指针与axTOCControl1控件绑定,导致调用m_menuMap.PopupMenu(e.x,e.y,m_tocControl.hWnd);时m_tocControl.hWnd为NULL,故无法弹出菜单。

解决方法:在Form1_Load()函数中,添加如下代码:

m_tocControl=(ITOCControl2)this.axTOCControl1.Object;

目前已经发现的优化方案如下: 1、教程第四讲,坐标单位前面的esri,原用switch语句逐一替换,其实直接用取子串(Substring)的方法截去更方便。 修改代码如下:

CoordinateLabel.Text=\当前坐标X=\.ToString()+\Substring(4);

2、教程第四讲,固定状态栏中的比例尺和当前坐标项目的宽度以防止闪烁。 方法如下:

选中状态栏中的比例尺或当前坐标项目,把其autoSize属性设为False,再在Size属性里设置宽度。经测试,比例尺宽度为150,当前坐标宽度为400比较合适。

第七讲 图层符号选择器的实现1

40

在上一讲中,我们实现了右键菜单(ContextMenu)的添加与实现,在最后我预留给下一讲的问题是TOCControl控件图层拖拽的实现。后来发现此功能的实现异常简单,只要在TOCControl的属性页中,勾选“EnableLayerDragandDrop”即可。

这一讲,我们要实现的是图层符号选择器,与ArcMap中的SymbolSelector的类似。本讲较前几讲而言,些许有些复杂,不过只要仔细琢磨,认真操作,你就很容易实现如下所示的符号选择器。因为本讲篇幅较长,故我将其分成两个阶段,本文是第一阶段。

图1

在AE开发中,符号选择器有两种实现方式。

一是在程序中直接调用ArcMap中的符号选择器,如下所示:

41

图2

二是自定义符号选择器,如图1所示。

由于第一种方式前提是必须安装ArcGISDesktop,其界面还是英文的,而对二次开发来说,大部分用户希望应该是中文界面。因此开发人员通常选择第二种方式,本讲也着重讲解第二种方式。

通过对《ArcGISEngine+C#实例开发教程》前六讲的学习,我已经假定你已经基本熟悉C#语言和VS2005的操作,故在下面的教程中,我不准备说明每一步骤的具体操作方法,而只是说明操作步骤,以节省时间和篇幅. 1.直接调用ArcMap中的符号选择器

(1)添加ESRI.ArcGIS.DisplayUI的引用。 分别在解决方案管理器和代码中添加引用。 (2)添加TOCControl的Double_Click事件。 (3)实现TOCControl的Double_Click事件。 因为种方法不是本讲的重点,故不对代码进行分析,有兴趣的读者请自行理解或结合后面的内容理解。代码如下:

42

43

2.自定义符号选择器

AE9.2提供了SymbologyControl控件,极大的方便了图层符号选择器的制作。本讲实现的符号选择器有如下功能。

用户双击TOCControl控件中图层的符号时,弹出选择符号对话框,对话框能够根据图层类型自动加载相应的符号,如点、线、面。用户可以调整符号的颜色、线宽、角度等参数。还可以打开自定义的符号文件(*.ServerStyle),加载更多的符号。

2.1新建符号选择器窗体

新建Winodws窗体,命名为SymbolSelectorFrm,修改窗体的Text属性为“选择符号”。并添加SymboloryControl、PictureBox、Button、Label、NumericUpDown、GroupBox、ColorDialog、OpenFileDialog、ContextMenuStrip控件。控件布局如下所示:

44

图3

2.2设置控件属性

设置相应控件的相关属性,如下表所示(空则不用修改):

45

46

2.3添加引用

在解决方案资源管理器中添加ArcGISEngine的ESRI.ArcGIS.Geodatabase引用,在SymbolSelectorFrm.cs文件中添加如下引用代码:

2.4初始化

(1)添加SymbolSelectorFrm的全局变量,代码如下:

47

修改SymbolSelectorFrm的构造函数,传入图层和图例接口。代码如下:

(3)添加SymbolControl的SymbologyStyleClass设置函数SetFeatureClassStyle(),代码如下:

48

4)添加注册表读取函数ReadRegistry(),此函数从注册表中读取ArcGIS的安装路径,代码如下:

(5)添加SymbolSelectorFrm的Load事件。根据图层类型为SymbologyControl导入相应的

49

符号样式文件,如点、线、面,并设置控件的可视性。代码如下:

50

本文来源:https://www.bwwdw.com/article/ufzo.html

Top