桌面GIS应用程序框架的建立.docx

《桌面GIS应用程序框架的建立.docx》由会员分享，可在线阅读，更多相关《桌面GIS应用程序框架的建立.docx（61页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、第一讲:桌面GIS应用程序框架的建立本讲主要是使用 MapControl、PageLayoutControl、ToolbarControl, TOCControl 四个控件建立起基本 的桌面GIS应用程序框架。最终成果预览如下:1、新建项目启动VS2005,选择文件I新建I项目”,在项目类型中选择Visual C#,再选择Windows应用程序模 板,输入名称“3sdnMap”，点击确定。在解决方案管理器中将“Forml.cs”重命名为“3sdnMap.cs”，在设计视图中，选中窗体，将其属性 中的 “Text” 改为 “3sdnMap”。2、添加控件选择工具箱中的“菜单和工具栏IMenuSt

2、rip”,将其拖入窗体。选择工具箱中的ArcGIS Windows Forms节,将ToolbarControl”控件拖入窗体,并将其属性中 的Dock设置为Top。选择工具箱中的“菜单和工具栏IStatusStrip”,将其拖入到窗体。选择工具箱中的“容器ISplitContainer”容器拖入窗体,并将其属性中的Dock设置为Fill。将TabContro!控件拖入Pane”,将Alignment属性设置为Bottom, Dock属性设置为Fill。点击TabPages 属性右边的按钮,弹出TabPage集合编辑器，将tabPagel的Name设置为tabPageLayer, Text设置

3、为 图层,将tabPage2的Name设置为tabPageProperty, Text设置为属性。如下所示。选择“图层”选项卡，拖入TOCControl控件，设置Dock属性为FilL选择属性”选项卡,拖入DataGridView控件，设置Dock属性为Fill。拖入TabContro!控件到Panel2,设置Dock属性为Fil并上述类似的方法，将两个选项卡的Name和 Text 分别设置为:（tabPageMap、地图,（tabPageLayout,制版）。选择“地图”选项卡，拖入MapControl控件,设置Dock属性为Fill。选择“制版”选项卡,拖入PageLayoutContro

4、l控件,设置Dock属性为Fill。最后将LicenseContro!控件拖入到窗体的任意地方。按F5编译运行，可以看到刚布局好的程序界面了。3、控件绑定通过以上步骤添加的控件还只是单独存在,而我们的程序需要各控件间协同工作,因此要进行控件 绑定。分别右击 ToolbarControl、TOCControl 控件，将 Buddy 设置为 axMapControll,如下图所示。属性这样,工具条和图层控件就与地图控件关联了。4、添加工具此时,工具条中还没有任何工具,添加的方法也很简单。右击ToolbarControl,选择“属性lltems”， 点击Add,选择Commands选项卡中的Gene

5、ric,双击Open、SaveAs、Redo、Undo即可将相应工具 添加到工具条。常见的工具有:Map Navigation中的导航工具,Map Inquiry中的查询工具，Feature Selection中的选择工具，你可以 根据需要酌情添加工具。5、编译运行按F5即可编译运行程序，至此桌面GIS应用程序框架基本框架已经搭建好了，你可以通过工具条的 工具打开地图文档，浏览地图了,效果如开篇所示.第二讲菜单的添加及其实现在上一讲中，我们实现了应用程序基本框架，其中有个小错误，在此先跟大家说明下。在“属性” 选项卡中，我们当时添加的是DataGridView控件，这个控件是用来显示数据表的，

6、而专门用于属性 的查询和设置的控件是PropertyGrid控件。因此请你删除“属性”选项卡中的DataGridView控件, 再把位于“工具箱I所有Windows窗体IPropertyGrid ”（如果没有，右击选择“选择项”以添加此控件）控件拖到该选项卡。在这讲中,主要讲解菜单的添加和实现。1、添加菜单在设计视图中,单击菜单栏,会出现“请在此处键入”的提示,单击提示就可以键入菜单名称,如 “文件”,再单击“文件”,即可输入其下拉子菜单，如下所示:Tips ：每创建一个菜单,请在其属性面板中设置Name属性，而且不要为中文，因此Name值将是此菜单 响应函数的函数名的一部分，带中文的函数名,

7、总是不好吧。本讲中，我们将添加新建（New ）、打开（Open ）、添加数据（AddData ）、保存（Save ）、另 存为（SaveAs ）、退出（Exit ）这些菜单，（）内为相应的Name属性值。Tips:你可以在属性面板中的Text属性中，把菜单名设置为中英文形式,如“打开Open ”,带下划线的 表示此项菜单的快捷键是字母 ,设置方法是在相应字母前加上“ & ”铜 如打开&Open ”。 但这种快捷键只在打开此下拉菜单时有效,即当你单击“文件”菜单弹出下拉菜单时，按下字母 就可以定位到“打开”菜单。还有一种在程序运行时都有效的全局快捷键，可以在属性面板中的“ ShortCutKey

8、s ”中设置。 你还可以在属性面板中的Image属性中设置你喜欢的菜单图标。单击!mage那一行右边的按钮, 弹出如下菜单。选择“项目资源文件”,再单击导入就可以选择你的图标了。最终效果如下所示。第 3sdnlap文件j|ontrol地画制版ArcGIS IName: 新建New打开Qpen胡 添加数据Add Data保存Save也另存为Save As触退出Exit!口舌在此7W注意,在解决方案面板中,选中刚添加的所有图标,在其属性面板中将生成操作设置为“嵌入的 资源”,这一点很重要!2、实现相关菜单首先定义指针(写在public partial class Forml : Form下面即可)

9、：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

10、 ESRI.ArcGIS.Geometry;using ESRI.ArcGIS.SystemUI;在设计视图中的属性面板中,选择Forml ,即主窗体,单击事件按钮(闪电形状的那个按钮),打 到“ Load ”事件并双击,添加此事件。在Forml.Load函数中初始化这些指针:/ 取得 MapControl 和 PageLayoutControl 的弓I 用m_mapControl = (IMapControl3)this.axMapControl 1 .Object;m_pageLayoutControl = (IPageLayoutControl2)this.axPageLayoutCon

11、trol 1 .Object;依次双击每个菜单项,添加菜单响应函数。实现代码如下：III /Z新建地图命令III / / private void New_Click(object sender, EventArgs e)/本命令涉及到M叩Control和PageLayoutControl同步问题,将在下讲中实现/ III打开地图文档Mxd命令III III / private void Open_Click(object sender, EventArgs e)/本命令涉及到MapControl和PageLayoutControl同步问题,将在下讲中实现 )III /添加数据命令III /

12、/ private void AddData_Click(object sender, EventArgs e) int currentLayerCount = this.axMapControl 1 .LayerCount;ICommand pCommand = new ControlsAddDataCommandClass();pCommand.OnCreate(this.axMapControl 1 .Object);pCommand.OnClick(); / /Z保存地图文档命令/ III / private void Save_Click(object sender, EventAr

13、gs e) /首先确认当前地图文档是否有效if(null!=m_pageLayoutControl. DocumentFi lename&m_mapControl.CheckMxFile(m_pageLayoutControl.DocumentFilename) /Z创建一个新的地图文档实例IMapDocument mapDoc = new MapDocumentClass();/Z打开当前地图文档mapDoc.Open(m_pageLayoutControl.DocumentFilename, string.Empty);/Z用PageLayout中的文档替换当前文档中的PageLayout

14、部分mapDoc.ReplaceContents(IMxdContents)m_pageLayoutControLPageLayout);/Z保存地图文档mapDoc.Save(mapDoc.UsesRelativePaths, false);mapDoc.Close(); / 另存为地图文档命令/ III / private void SaveAs_Click(object sender, EventArgs e) 调用另存为命令ICommand command = new ControlsSaveAsDocCommandClass();command.OnCreate(m_controls

15、Synchronizer.ActiveControl);command.OnClick(); / /Z退出程序/ / / private void Exit_Click(object sender, EventArgs e) Application.Exit();)3、编译运行按F5编译运行程序。也许你会发现,菜单命令的实现方式都是类型的。没错,在AE9.2中,内置 了许多常用的 Command 和 Tool ,如 ControlsAddDataCommandClass ControlsMapZoomlnToolClass ControlsMapPanToolClass 等等, 这些内置对象在

16、 ESRI.ArcGIS.Controls命名空间中,你可以对象浏览器中查看。而且这些内置对象的调用方式都类似, 如下所示:/Z定义ICommand command = new ControlsSaveAsDocCommandClass();/Z创建command.OnCreate(m_controlsSynchronizer.ActiveControl);/Z调用command.OnClick();第三讲 MapControl 与 PageLayoutControl 同步在Arc Map中,能够很方面地进行MapView和Layout View两种视图的切换,而且二者之间的数据 是同步显示的

17、。关于两种视图同步的实现方法有多种,可以使用ObjectCopy对象进行数据硬拷贝,而比较简单的方 法莫过于二者共享一份地图了,这也是最常用的方法。1、新建同步类 ControlsSynchronizer在解决方案面板中右击项目名,选择“添加I类”,在类别中选择“Visual C#项目项”,在模板中选择 “类”,输入类名“ConlrolsSynchronizer.cs”,将以下代码覆盖自动生成的代码:using System;using System.Drawing;using System.Collections;using System.ComponentModel;using Syste

18、m.Windows.Forms;using System.IO;using System.Runtime.InteropServices;using ESRI.ArcGIS.esriSystem;using ESRI.ArcGIS.Carto;using ESRI.ArcGIS.Controls;using ESRLArcGIS.SystemUI;namespace _sdnMap/ / This class is used to synchronize a gven PageLayoutControl and a MapControl./ When initialized, the user

19、 must pass the reference of these control to the class, bindIll the control together by calling BindControls which in turn sets a joined Map referencedIII by both control; and set all the buddy controls joined between these two controls./ When alternating between the MapControl and PageLayoutControl

20、, you should activate the visible control/ and deactivate the other by calling ActivateXXX.Ill This calss is limited to a situation where the controls are not simultaneously visible./ public class ControlsSynchronizer #region class membersprivate IMapControl3 m_mapControl = null;private IPageLayoutC

21、ontrol2 m_pageLayoutControl = null;private ITool m_mapActiveTool = null;private ITool m_pageLayoutActivelbol = null;private bool m_IsMapCtrlactive = true;private ArrayList m_frameworkControls = null;#endregion#region constructor/ /Z默认构造函数III public ControlsSynchronizer() (初始化 ArrayList m_frameworkCo

22、nlrols = new ArrayList(); ) / /Z构造函数 / / / public ControlsSynchronizer(IMapControl3 mapControl, IPageLayoutControl2 pageLayoutControl) :this() (为类成员赋值m_mapControl = mapControl;m_pageLayoutControl = pageLayoutControl;#endregion#region propertiesIII III取得或设置MapControlIII public IMapControl3 MapControl

23、get return m_mapControl; set m_mapControl = value; )/ / 取得或设置 PageLayoutControlIII public IPageLayoutControl2 PageLayoutControl (get return m_pageLayoutControl; set m_pageLayoutControl = value;) / /取得当前ActiveView的类型/ public string ActiveViewType (getif (mJsMapCtrlactive) return MapContro;elsereturn

24、nPageLayoutControl;) ) / /Z取得当前活动的Control III public object ActiveControlI get if (m_mapControl = null II m_pageLayoutControl = null)throw new Exception(uControlsSynchronizer:ActiveControl:rnEither MapControl or PageLayoutControl are not initialized!1);if (mJsMapCtrlactive)return m_mapControl.Object

25、; elsereturn m_pageLayoutControl .Object;) )#endregion#region MethodsIII / 激活 MapControl 并解除 the PagleLayoutControlIII public void ActivateMapO (tryif (m_pageLayoutControl = null II m_mapControI = null)throw new Exception(ControlsSynchronizer:ActivateMap:rnEither MapControl or PageLayoutControl are

26、not initialized!1);缓存当前 PageLayout 的 CurrentToolif (m_pageLayoutControl.CurrentTool != null) m_pageLayoutActiveTool = m_pageLay outControl .CurrentTool;解除 PagleLayoutm_pageLayoutControi. Active View.Deactivate();激活 MapControlm_mapControLActiveView.Activate(m_mapControl.hWnd);将之前MapControl最后使用的tool,作

27、为活动的tool赋给MapControl的 CurrentToolif (m_mapActiveTool != null) m_mapControl.CurrentTool = m_mapActivelbol; m_I sM apC tri ac ti ve = true;为每个的 framework controls,设置 Buddy control 为 MapControl this.SetBuddies(m_mapControl.Object);)catch (Exception ex)throw new Exception(string.Format(ControlsSynchroni

28、zer 二 Acti vateMap:rn 0, ex.Message); ) / / 激活 PagleLayoutContro! 并减活 M叩Cotrol / public void ActivatePageLayout() tryif (m_pageLayoutControl = null II m_mapControl = null)throw new Exception(ControlsSynchronizer:ActivatePageLayout:rnEither MapControl or PageLayoutControl are not initialized!);缓存当前 M

29、apContro) 的 CurrentToolif (m_mapControl.CurrentTool != null) m_mapActiveTool = m_mapControl.CurrentTool;解除 MapControlm_mapControl. Active View.Deactivate();激活 PageLayoutControlm_pageLayoutControi. Active View. Acti vate(m_pageLayoutControl.hWnd);将之前PageLayoutControl最后使用的tool ,作为活动的tool ,赋给 PageLayou

30、tContro! 的 CurrentToolif (m_pageLay out Acti veTool != null) m_pageLay outControl.CurrentTool = m_pageLayoutActi veTool;mJsMapCtrlactive = false;为每个的 framework controls,设置 Buddy control 为 PageLayoutControlthis.SetBuddies(m_pageLayoutControI.Object); ) catch (Exception ex) thrownewException(string.Fo

31、rmat(ControlsSynchronizer:ActivatePageLayout:rn0, ex.Message); ) )/ /Z 给予个地图,置换 PageLayoutControl 和 M叩Control 的 focus map / III public void ReplaceMap(IMap newMap) (if (newMap = null)throw new Exception( ControlsSynchronizer: ReplaceMap:rnNew map for replacement is not initialized!);if (m_pageLayout

32、Control = null II m_mapControl = null)throw new Exception(ControlsSynchronizer:ReplaceMap:rnEither MapControl or PageLayoutControl are not initialized!);/create a new instance of IMaps collection which is needed by the PageLayout创建一个PageLayout需要用到的,新的IMaps collection的实例 IMaps maps = new Maps();/add

33、the new map to the Maps collection 把新的地图加到Maps collection里头去 maps.Add(newMap);bool blsMapActive = m_IsMapCtrlactive;/call replace map on the PageLayout in order to replace the focus map/we must call ActivatePageLayout, since it is the control we call ReplaceMaps 调用 PageLayout 的 replace map 来置换 focus

34、 imp/Z我们必须调用ActivatePageLayout,因为它是那个我们可以调用ReplaceMaps的 Controlthis.ActivatePageLayout();rn_pageLayoutControl.PageLayout.ReplaceMaps(maps);/assign the new map to the MapControl 把新的地图赋给MapControl m_mapControl.Map = newMap;/reset the active tools 重设 active tools m_pageLayoutActiveTool = null; m_mapAct

35、iveTool = null;/make sure that the last active control is activated 确认之前活动的control被激活 if (blsMapActive) (this.ActivateMap();m_mapControl. Active View.Refresh();) else ( this.ActivatePageLayout(); m_pageLayoutControl. Active View.Refresh();)/ / bind the MapControl and PageLayoutControl together by as

36、signing a new joint focus map / 指定共同的 Map 来把 MapControl 和 PageLayoutContro! 绑在起 III III / III true if the MapControl supposed to be activated first,如果 MapControl 被首先激活,则为 truepublic void BindControls(IMapControl3 mapControl, IPageLayoutControl2 pageLayoutControl, bool activateMapFirst)(if (mapContro

37、l = null II pageLayoutControl = null) throw new Exception(HControlsSynchronizer:BindControls:rnEither MapControl or PageLayoutControl are not initialized!1);m_mapControl = MapControl;m_pageLayoutControl = pageLayoutControl; this.BindControls(activateMapFirst);/ / bind the MapControl and PageLayoutCo

38、ntrol together by assigning a new joint focus map III 指定共同的 Map 来把 MapControl 和 PageLayoutContro! 绑在起 III III true if the MapControl supposed to be activated first,如果 MapControl 被首先激活,则为 truepublic void BindControls(bool activateMapFirst) (if (m_pageLayoutControl = null II m_mapControl = null)throw

39、new Exception(ControlsSynchronizer:BindControls:rnEither MapControl or PageLayoutControl are not initialized!);/create a new instance of IMap创造IMap的个实例IMap newMap = new MapClass。; newMap.Name = Map;/create a new instance of IMaps collection which is needed by the PageLayout 创造个新的IMaps collection的实例,

40、这是PageLayout所需要的 IMaps maps = new Maps();/add the new Map instance to the Maps collection把新的Map实例赋给Maps collection maps.Add(newMap);/call replace map on the PageLayout in order to replace the focus map调用 PageLayout 的 replace map 来置换 focus map m_pageLayoutControLPageLayout.ReplaceMaps(maps);/assign t

41、he new map to the MapControl把新的m叩赋给MapControl m_mapControl.Map = newMap;/reset the active tools重设 active toolsm_pageLayoutActiveTool = null;m_mapActiveTool = null;/make sure that the last active control is activated确定最后活动的control被激活if (activateMapFirst)this.ActivateMapO;elsethis.ActivatePageLayout()

42、;1/ /by passing the applications toolbars and TOC to the synchronization class, it saves you the /management of the buddy control each time the active control changes. This method ads the framework/control to an array; once the active control changes, the class iterates through the array and /calles

43、 SetBuddyControl on each of the stored framework control./ / public void AddFrameworkControl(object control)(if (control = null)throw newException(ControlsSynchronizer:AddFrameworkControl:rn Addedcontrol is not initialized!);m_frameworkControls.Add(control);/ / Remove a framework control from the managed list of controlsIII / public void RemoveFra