ArcGIS_Engine+C_实例开发教程.pdf

《ArcGIS_Engine+C_实例开发教程.pdf》由会员分享，可在线阅读，更多相关《ArcGIS_Engine+C_实例开发教程.pdf（85页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、ArcGIS Engine+C#实 例 开 发 教 程 第 一 讲：桌 面 GIS应 用 程 序 框 架 的 建 立 本 讲 主 要 是 使 用 MapControl PageLayoutControR ToolbarControK TOCControl 四 个 控 件 建 立 起 基 本 的 桌 面 GIS应 用 程 序 框 架。最 终 成 果 预 览 如 下：1、新 建 项 目 启 动 VS2005,选 择“文 件|新 建 I项 目”，在 项 目 类 型 中 选 择 Visual C#,再 选 择 Windows应 用 程 序 模 板，输 入 名 称“3sdnMap”，点 击 确 定。田

2、园 新 建 项 目 在 解 决 方 案 管 理 器 中 将“Forml.cs”重 命 名 为“3sdnMap.cs”，在 设 计 视 图 中,选 中 窗 体，将 其 属 性 中 的“Text”改 为“3sdnMap”。2、添 加 控 件 选 择 工 具 箱 中 的“菜 单 和 工 具 栏 I MenuStrip”，将 其 拖 入 窗 体。选 择 工 具 箱 中 的 ArcGIS Windows Forms 节,将 ToolbarControl”控 件 拖 入 窗 体，并 将 其 属 性 中 的 Dock设 置 为 Top。选 择 工 具 箱 中 的“菜 单 和 工 具 栏 I StatusSt

3、rip”，将 其 拖 入 到 窗 体。选 择 工 具 箱 中 的“容 器 ISplitContainer”容 器 拖 入 窗 体，并 将 其 属 性 中 的 Dock设 置 为 Fillo将 TabControl控 件 拖 入 Panel 1,将 Alignment属 性 设 置 为 Bottom,Dock属 性 设 置 为 Fill。点 击 TabPages属 性 右 边 的 按 钮，弹 出 TabPage集 合 编 辑 器，将 tabPage 1 的 Name设 置 为 tabPageLayer,Text 设 置 为 图 层，将 tabPage2 的 Name 设 置 为 tabPageP

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

5、置 Dock属 性 为 Fill。选 择 制 版 选 项 卡，拖 入 PageLayoutControl控 件,设 置 Dock属 性 为 Fill。最 后 将 LicenseControl控 件 拖 入 到 窗 体 的 任 意 地 方。按 F5编 译 运 行，可 以 看 到 刚 才 布 局 好 的 程 序 界 面 了。3、控 件 绑 定 通 过 以 上 步 骤 添 加 的 控 件 还 只 是 单 独 存 在，而 我 们 的 程 序 需 要 各 控 件 间 协 同 工 作，因 此 要 进 行 控 件 绑 定。分 别 右 击 ToolbarControl、TOCControl 控 件,将 Bud

6、dy 设 置 为 axMapControll,如 下 图 所 示。这 样，工 具 条 和 图 层 控 件 就 与 地 图 控 件 关 联 了。4、添 加 工 具 此 时，工 具 条 中 还 没 有 任 何 工 具，添 加 的 方 法 也 很 简 单。右 击 ToolbarControl,选 择 属 性|Items”,点 击 Add,选 择 Commands选 项 卡 中 的 Generic,双 击 Open、SaveAs、Redo、Undo即 可 将 相 应 工 具 添 加 到 工 具 条。常 见 的 工 具 有：Map Navigation中 的 导 航 工 具，Map Inquiry中 的

7、 查 询 工 具，Feature Selection中 的 选 择 工 具，你 可 以 根 据 需 要 酌 情 添 加 工 具。5、编 译 运 行 按 F5即 可 编 译 运 行 程 序，至 此 桌 面 GIS应 用 程 序 框 架 基 本 框 架 已 经 搭 建 好 了，你 可 以 通 过 工 具 条 的 工 具 打 开 地 图 文 档，浏 览 地 图 了，效 果 如 开 篇 所 示。第 二 讲 菜 单 的 添 加 及 其 实 现 在 上 一 讲 中，我 们 实 现 了 应 用 程 序 基 本 框 架，其 中 有 个 小 错 误，在 此 先 跟 大 家 说 明 下。在“属 性”选 项 卡 中

8、，我 们 当 时 添 加 的 是 DataGridView控 件，这 个 控 件 是 用 来 显 示 数 据 表 的，而 专 门 用 于 属 性 的 查 询 和 设 置 的 控 件 是 PropertyGrid控 件。因 此 请 你 删 除 属 性 选 项 卡 中 的 DataGridView控 件，再 把 位 于“工 具 箱|所 有 Windows窗 体|PropertyGrid（如 果 没 有，右 击 选 择“选 择 项”以 添 加 此 控 件）控 件 拖 到 该 选 项 卡。在 这 一 讲 中，主 要 讲 解 菜 单 的 添 加 和 实 现。1、添 加 菜 单 在 设 计 视 图 中，单

9、 击 菜 单 栏，会 出 现“请 在 此 处 键 入”的 提 示，单 击 提 示 就 可 以 键 入 菜 单 名 称，如“文 件”，再 单 击“文 件”，即 可 输 入 其 下 拉 子 菜 单，如 下 所 示：imgjfile:/C:/Documents%20and%20Settings/Administrator/Local%20Settings/Temporary%20Internet%20Files/Content.IE5/WVUJQZMD/20090512083746513%5Bl%5D.jpg/imgTips：每 创 建 一 个 菜 单，请 在 其 属 性 面 板 中 设 置 Nam

10、e属 性，而 且 不 要 为 中 文，因 此 Name值 将 是 此 菜 单 响 应 函 数 的 函 数 名 的 一 部 分，带 中 文 的 函 数 名，总 是 不 好 吧。本 讲 中，我 们 将 添 加 新 建（New）、打 开（Open）、添 加 数 据（AddData）、保 存（Save）、另 存 为（SaveAs）、退 出（Exit）这 些 菜 单，（）内 为 相 应 的 Name属 性 值。Tips:你 可 以 在 属 性 面 板 中 的 Text属 性 中，把 菜 单 名 设 置 为 中 英 文 形 式，如“打 开 Open”，带 下 划 线 的 0 表 示 此 项 菜 单 的 快

11、 捷 键 是 字 母 0,设 置 方 法 是 在 相 应 字 母 前 加 上“&”字 符，如“打 开&0pen”。但 这 种 快 捷 键 只 在 打 开 此 下 拉 菜 单 时 才 有 效，即 当 你 单 击“文 件”菜 单 弹 出 下 拉 菜 单 时，按 下 字 母 0 就 可 以 定 位 到“打 开”菜 单。还 有 一 种 在 程 序 运 行 时 都 有 效 的 全 局 快 捷 键，可 以 在 属 性 面 板 中 的“ShortCutKeys”中 设 置。你 还 可 以 在 属 性 面 板 中 的 Image属 性 中 设 置 你 喜 欢 的 菜 单 图 标。单 击 Image那 行 右

12、边 的 按 钮，弹 出 如 下 菜 单。选 择“项 目 资 源 文 件”，再 单 击 导 入 就 可 以 选 择 你 的 图 标 了。选 择 黄 源 项 目 资 源 文 件 9：资 源 上 下 文 O 本 地 资 源(L):e,x(M,|I 港 阵 E导 入;&最 终 效 果 如 下 所 示。/朝 口 冉 触 一,一-新 建 N ew ontrol打 开 Open添 加 数 据 Add Data保 存 Save另 存 为 Save As地 图 制 版 SArcGIS EName:i退 出 E xit!.:.年 注 意，在 解 决 方 案 面 板 中，选 中 刚 才 添 加 的 所 有 图 标，

13、在 其 属 性 面 板 中 将 生 成 操 作 设 置 为“嵌 入 的 资 源”，这 一 点 很 重 要！2、实 现 相 关 菜 单 首 先 定 义 指 针(写 在 public partial class Forml:Form下 面 即 可)：private ESRI.ArcGIS.Controls.IMapControl3 m mapControl=null;private ESRL ArcGIS.Controls.IPageLayoutControl2 m pageLayoutControl=null;private IMapDocument pMapDocument;若 以 上 指 针

14、 无 效，请 添 加 以 卜.引 用:using ESRI.ArcGIS.Carto;using ESRI.ArcGIS.Controls;using ESRI.ArcGIS.esriSystem;using ESRI.ArcGIS.Display;using ESRI.ArcGIS.Geometry;using ESRI.ArcGIS.SystemUI;在 设 计 视 图 中 的 属 性 面 板 中，选 择 Forml,即 主 窗 体，单 击 事 件 按 钮(闪 电 形 状 的 那 个 按 钮)，打 到“Load”事 件 并 双 击，添 加 此 事 件。在 Forml_Load函 数 中 初

15、 始 化 这 些 指 针：/取 得 MapControl 和 PageLayoutControl 的 引 用 m_mapControl=(IMapControl3)this.axMapControll.Object;m_pageLayoutControl=(IPageLayoutControl2)this.axPageLayoutControl1.Object;依 次 双 击 每 个 菜 单 项，添 加 菜 单 响 应 函 数。实 现 代 码 如 下：/新 建 地 图 命 令/private void New_Click(object sender,EventArgs e)(/本 命 令 涉

16、及 到 MapControl和 PageLayoutControl同 步 问 题，将 在 下 一 讲 中 实 现)/打 开 地 图 文 档 Mxd命 令/private void Open_Click(object sender,EventArgs e)(/本 命 令 涉 及 到 MapControl和 PageLayoutControl同 步 问 题，将 在 下 一 讲 中 实 现)/添 加 数 据 命 令/private void AddData_Click(object sender,EventArgs e)(int currentLayerCount=this.axMapControl

17、l.LayerCount;ICommand pCommand=new ControlsAddDataCommandClass();pCommand.OnCreate(this.axMapControll.Object);pCommand.OnClick();)/保 存 地 图 文 档 命 令/private void Save_Click(object sender,EventArgs e)(/首 先 确 认 当 前 地 图 文 档 是 否 有 效 if(null!=m_pageLayoutControl.DocumentFilename&m_mapControl.CheckMxFile(m_

18、pageLayoutControl.DocumentFilename)(/创 建 一 个 新 的 地 图 文 档 实 例 IMapDocument mapDoc=new MapDocumentClass();/打 开 当 前 地 图 文 档 mapDoc.Open(m_pageLayoutControl.DocumentFilename,string.Empty);/用 PageLayout中 的 文 档 替 换 当 前 文 档 中 的 PageLayout部 分 mapDoc.ReplaceContents(IMxdContents)m_pageLayoutControl.PageLayou

19、t);/保 存 地 图 文 档 mapDoc.Save(mapDoc.UsesRelativePaths,false);mapDoc.Close();)/另 存 为 地 图 文 档 命 令/private void SaveAs_Click(object sender,EventArgs e)/调 用 另 存 为 命 令 ICommand command=new ControlsSaveAsDocCommandClassO;command.OnCreate(m_controlsSynchronizer.ActiveControl);command.OnClickO;)/退 出 程 序/priv

20、ate void Exit_Click(object sender,EventArgs e)(Application.Exit();3、编 译 运 行 按 F 5 编 译 运 行 程 序。也 许 你 会 发 现，菜 单 命 令 的 实 现 方 式 都 是 类 型 的。没 错，在 AE9.2中，内 置 了 许 多 常 用 的 Command 和 Tool,如 ControlsAddDataCommandClass、ControlsMapZoomlnToolClass、ControlsMapPanToolClass 等 等，这 些 内 置 对 象 在 ESRI.ArcGIS.Controls命 名

21、 空 间 中，你 可 以 对 象 浏 览 器 中 查 看。而 且 这 些 内 置 对 象 的 调 用 方 式 都 类 似，如 下 所 示：/定 义 ICommand command=new ControlsSaveAsDocCommandClassO;/创 建 command.OnCreate(m_controlsSynchronizer.ActiveControl);/调 用 command.OnClickO;第 三 讲 MapControl 与 PageLayoutControl 同 步(一)在 ArcMap中，能 够 很 方 面 地 进 行 MapView和 Layout View两 种

22、 视 图 的 切 换，而 且 二 者 之 间 的 数 据 是 同 步 显 示 的。关 于 两 种 视 图 同 步 的 实 现 方 法 有 多 种，可 以 使 用 ObjectCopy对 象 进 行 数 据 硬 拷 贝，而比 较 简 单 的 方 法 莫 过 于 二 者 共 享 一 份 地 图 了，这 也 是 最 常 用 的 方 法。1、新 建 同 步 类 ControlsSynchronizer在 解 决 方 案 面 板 中 右 击 项 目 名,选 择“添 加 I类”，在 类 别 中 选 择“Visual C#项 目 项”,在 模 板 中 选 择“类”，输 入 类 名 ControlsSynch

23、ronizer.cs”,将 以 下 代 码 覆 盖 自 动 生 成 的 代 码：using System;using System.Drawing;using System.Collections;using System.ComponentModel;using System.Windows.Forms;using System.10;using System.Runtime.InteropServices;using ESRI.ArcGIS.esriSystem;using ESRI.ArcGIS.Carto;using ESRI.ArcGIS.Controls;using ESRI.Ar

24、cGIS.SystemUI;namespace _sdnMap(/This class is used to synchronize a gven PageLayoutControl and aMapControl./When initialized,the user must pass the reference of these control tothe class,bind/the control together by calling BindControls which in turn sets ajoined Map referenced/by both control;and

25、set all the buddy controls joined between thesetwo controls./When alternating between the MapControl and PageLayoutControl,youshould activate the visible control/and deactivate the other by calling ActivateXXX./This calss is limited to a situation where the controls are notsimultaneously visible./pu

26、blic class ControlsSynchronizerftregion class membersprivate IMapControl3 m_mapControl=null;private IPageLayoutControl2 m_pageLayoutControl=null;private ITool m_mapActiveTool=null;private ITool m_pageLayoutActiveTool=null;private bool m_IsMapCtrlactive=true;private ArrayList m_frameworkControls=null

27、;ttendregionftregion constructor/默 认 构 造 函 数/public ControlsSynchronizer0(初 始 化 ArrayListm_frameworkControls=new ArrayList();)/构 造 函 数/public ControlsSynchronizer(IMapControl3 mapControl,IPageLayoutControl2 pageLayoutControl):this 0(为 类 成 员 赋 值 m_mapControl=mapControl;m_pageLayoutControl=pageLayoutC

28、ontrol;)ttendregionftregion properties/取 得 或 设 置 MapControl/public IMapControl3 MapControlget return m_mapControl;set m_mapControl=value;)/取 得 或 设 置 PageLayoutControl/public IPageLayoutControl2 PageLayoutControl(get return m_pageLayoutControl;set m_pageLayoutControl=value;)/取 得 当 前 ActiveView的 类 型/p

29、ublic string ActiveViewType(get(if(m_IsMapCtrlactive)return MapControl”;elsereturn PageLayoutControl”;)/取 得 当 前 活 动 的 Control/public object ActiveControl(get(if(m_mapControl=null j|m_pageLayoutControl=null)throw newException(ControlsSynchronizer:ActiveControl:rnEither MapControl orPageLayoutControl

30、are not initialized!;if(m_IsMapCtrlactive)return m_mapControl.Object;elsereturn m_pageLayoutControl.Object;)ttendregionftregion Methods/激 活 MapControl 并 解 除 the PagleLayoutControl/public void ActivateMapO(try(if(m_pageLayoutControl=null j|m_mapControl=null)throw newException(z，ControlsSynchronizer:A

31、ctivateMap:rnEither MapControl orPageLayoutControl are not initialized!，z);缓 存 当 前 PageLayout 的 CurrentToolif(m_pageLayoutControl,CurrentTool!=null)m_pageLayoutActiveTool=m_pageLayoutControl.CurrentTool;解 除 PagleLayoutm_pageLayoutControl.ActiveView.Deactivate();激 活 MapControlm_mapControl.ActiveView.

32、Activate(m_mapControl.hWnd);将 之 前 MapControl最 后 使 用 的 tool,作 为 活 动 的 tool,赋 给 MapControl 的 CurrentToolif(m_mapActiveToo1!=null)m_mapControl.CurrentTool=m_mapActiveTool;m_IsMapCtr1active=true;为 每 一 个 的 framework controls,设 置 Buddy control 为 MapControlthis.SetBuddies(m_mapControl.Object);catch(Excepti

33、on ex)throw newException(string.Format(，zControlsSynchronizer:ActivateMap:rn 0z，,ex.Message);)/激 活 PagleLayoutControl 并 减 活 MapCotrol/public void ActivatePageLayout()(try(if(m_pageLayoutControl=null j|m_mapControl=null)throw newException(/zControlsSynchronizer:ActivatePageLayout:rnEither MapControl

34、orPageLayoutControl are not initialized!，z);缓 存 当 前 MapControl 的 CurrentToolif(m_mapControl.CurrentTool!=null)m_mapActiveTool=m_mapControl.CurrentTool;/解 除 MapControlm_mapControl.ActiveView.Deactivate();激 活 PageLayoutControlm_pageLayoutControl.ActiveView.Activate(m_pageLayoutControl.hWnd);将 之 前 Page

35、LayoutControl最 后 使 用 的 tool,作 为 活 动 的 tool,赋 给 PageLayoutControl 的 CurrentToolif(m_pageLayoutActiveTool!=null)m_pageLayoutControl.CurrentTool=m_pageLayoutActiveTool;m_IsMapCtrlactive=false;为 每 一 个 的 framework controls,设 置 Buddy control 为 PageLayoutControlthis.SetBuddies(m_pageLayoutControl.Object);c

36、atch(Exception ex)throw newException(string.Format(，zControlsSynchronizer:ActivatePageLayout:rn 0，ex.Message);)/给 予 一 个 地 图，置 换 PageLayoutControl 和 MapControl 的 focus map/public void ReplaceMap(IMap newMap)(if(newMap=null)throw newException(/zControlsSynchronizer:ReplaceMap:rnNew map for replacement

37、 isnot initialized!)；if(m_pageLayoutControl=null I|m_mapControl=null)throw newException(ControlsSynchronizer:ReplaceMap:rnEither MapControl orPageLayoutControl are not initialized!，z);/create a new instance of I Maps collection which is needed by thePageLayout 创 建 一 个 PageLayout需 要 用 到 的，新 的 IMaps c

38、ollection的 实 例 I Maps maps=new Maps();/add 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 focusmap/we must call ActivatePageLayout,since it is the control we callRe

39、placeMaps)调 用 PageLayout 的 replace map 来 置 换 focus map 我 们 必 须 调 用 ActivatePageLayout,因 为 它 是 那 个 我 们 可 以 调 用“ReplaceMaps”的 Controlthis.ActivatePageLayout();m_pageLayoutContro1.PageLayout.ReplaceMaps(maps);/assign the new map to the MapControl 把 新 的 地 图 赋 给 MapControlm_mapControl.Map=newMap;/reset t

40、he active tools 重 设 active toolsm_pageLayou tAc t i veToo1=null;m_mapActiveTool=null;/make sure that the last active control is activated 确 认 之 前 活 动 的 control被 激 活 if(blsMapActive)(this.ActivateMapO;m_mapControl.ActiveView.Refresh();)else(this.ActivatePageLayout();m_pageLayoutControl.ActiveView.Ref

41、resh();)/bind the MapControl and PageLayoutControl together by assigning anew joint focus map/指 定 共 同 的 Map 来 把 MapControl 和 PageLayoutContro 1 绑 在 一 起/true if the MapControl supposed tobe activated first,如 果 MapControl 被 首 先 激 活，则 为 truepublic void BindControls(IMapControl3 mapControl,IPageLayoutCo

42、ntro 12PageLayoutControl,bool activateMapFirst)(if(mapControl=null|pageLayoutControl=null)throw newException(/zControlsSynchronizer:BindControls:rnEither MapControl orPageLayoutControl are not initialized!;m_mapControl=MapControl;m_pageLayou tCon tro1=pageLayoutControl;this.BindControls(activateMapF

43、irst);)/bind the MapControl and PageLayoutControl together by assigning anew joint focus map/指 定 共 同 的 Map 来 把 MapControl 和 PageLayoutControl 绑 在 一 起/true if the MapControl supposed tobe activated first,如 果 MapControl 被 首 先 激 活，则 为 truepublic void BindControls(bool activateMapFirst)(if(m_pageLayoutC

44、ontrol=null I|m_mapControl=null)throw newException(/zControlsSynchronizer:BindControls:rnEither MapControl orPageLayoutControl are not initialized!，z);/create a new instance of IMap 创 造 IMap的 一 个 实 例 IMap newMap=new MapClass();newMap.Name=Map;/create a new instance of I Maps collection which is need

45、ed by thePageLayout 创 造 一 个 新 的 I Maps collection的 实 例,这 是 PageLayout所 需 要 的 I Maps maps=new Maps();/add the new Map instance to the Maps collection 把 新 的 Map实 例 赋 给 Maps collectionmaps.Add(newMap);/call replace map on the PageLayout in order to replace the focusmap 调 用 PageLayout 的 replace map 来 置

46、换 focus mapm_pageLayoutControl.PageLayout.ReplaceMaps(maps);/assign the new map to the MapControl 把 新 的 map赋 给 MapControlm_mapControl.Map=newMap;/reset the active tools 重 设 active toolsm_pageLayou tAc t i veToo1=null;m_mapActiveTool=null;/make sure that the last active control is activated/确 定 最 后 活

47、 动 的 control被 激 活 if(activateMapFirst)this.ActivateMapO;elsethis.ActivatePageLayout();)/by passing the application，s toolbars and TOC to the synchronizationclass,it saves you the/management of the buddy control each time the active control changes.This method ads the framework/control to an array;on

48、ce the active control changes,the classiterates through the array and/calles SetBuddyControl on each of the stored framework control./public void AddFrameworkControl(object control)(if(control=null)throw newException(/zControlsSynchronizer:AddFrameworkControl:rnAdded control isnot initialized!，z);m_

49、frameworkControls.Add(control);)/Remove a framework control from the managed list of controls/public void RemoveFrameworkControl(object control)if(control=null)throw newException(z，ControlsSynchronizer:RemoveFrameworkControl:rnControl to beremoved is not initialized!);m_frameworkControls.Remove(cont

50、rol);)/Remove a framework control from the managed list of controls byspecifying its index in the list/public void RemoveFrameworkControlAt(int index)(if(m_frameworkControls.Count index)throw newException(/zControlsSynchronizer:RemoveFrameworkControlAt:rnlndex is outof range!)；m_frameworkControls.Re