《桌面GIS应用程序框架的建立.docx》由会员分享,可在线阅读,更多相关《桌面GIS应用程序框架的建立.docx(61页珍藏版)》请在taowenge.com淘文阁网|工程机械CAD图纸|机械工程制图|CAD装配图下载|SolidWorks_CaTia_CAD_UG_PROE_设计图分享下载上搜索。
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