ArcGISEngine9.2+C#實例開發(fā)詳細教程

1、本講主要是使用MapCont、PageLayoutControl、Toolbarcontrol、TOCControl四個控件建立起基本的桌面GIS應(yīng)用程序框架。最終成果預(yù)覽如下：1、新建項目啟動VS2005,選擇“文件|新建|項于，在項目類型中選擇VisualC#，再選擇Windows應(yīng)用程序模板，輸入名稱“3sdnMap”點擊確定。在解決方案管理器中將“Form1.cs"重命名為“3sdnMap.cs”在設(shè)計視圖中，選中窗體，將其屬性中的“Text"改為“3sdnMap”2、添加控件選擇工具箱中的“菜單和工具欄|MenuStrip”，將其拖入窗體。選擇工具箱中的“ArcG

2、ISWindowsForms”節(jié)，將“ToolbarControl”控件拖入窗體，并將其屬性中的Dock設(shè)置為Top。選擇工具箱中的“菜單和工具欄|StatusStrip”，將其拖入到窗體。選擇工具箱中的“容器|SplitContainer”容器拖入窗體，并將其屬性中的Dock設(shè)置為Fill。將TabControl控件拖入Panel1，將Alignment屬性設(shè)置為Bottom，Dock屬性設(shè)置為Fill。點擊TabPages屬性右邊的按鈕，彈出TabPage集合編輯器，將tabPage1的Name設(shè)置為tabPageLayer，Text設(shè)置為圖層，將tabPage2的Name設(shè)置為tabPa

3、geProperty，Text設(shè)置為屬性。如下所示。威局（MroKH1jtabPePropS13?怯移除誦走取洎tabFtijeLtysir風性:.'!2選擇“圖層”選項卡，拖入TOCCont控件，設(shè)置Dock屬性為Fill。選擇“屬性”選項卡，拖入DataGridView控件，設(shè)置Dock屬性為Fill。拖入TabControl控件到Panel2，設(shè)置Dock屬性為Fill。并上述類似的方法，將兩個選項卡的Name和Text分別設(shè)置為：（tabPageMap、地圖），（tabPageLayout，制版）。選擇“地圖”選項卡，拖入MapCont控件，設(shè)置Dock屬性為Fill。選擇“制

4、版”選項卡，拖入PageLayoutControl控件，設(shè)置Dock屬性為Fill。最后將LicenseControl控件拖入到窗體的任意地方。按F5編譯運行，可以看到剛才布局好的程序界面了。3、控件綁定通過以上步驟添加的控件還只是單獨存在，而我們的程序需要各控件間協(xié)同工作，因此要進行控件綁定。分別右擊ToolbarControl、TOCControl控件，將Buddy設(shè)置為axMapControl1，如下圖所示。這樣，工具條和圖層控件就與地圖控件關(guān)聯(lián)了4、添加工具此時，工具條中還沒有任何工具，添加的方法也很簡單。右擊ToolbarControl，選擇“屬性|ltems”，點擊Add，選擇Co

5、mmand選項卡中的Generic，雙擊OpenSaveAs、RedoUndo即可將相應(yīng)工具添加到工具條。常見的工具有:MapNavigation中的導航工具，MapInquiry中的查詢工具，F(xiàn)eatureSelection中的選擇工具，你可以根據(jù)需要酌情添加工具。5、編譯運行按F5即可編譯運行程序，至此桌面GIS應(yīng)用程序框架基本框架已經(jīng)搭建好了，你可以通過工具條的工具打開地圖文檔，瀏覽地圖了，效果如開篇所示。第二講菜單的添加及其實現(xiàn)在上一講中，我們實現(xiàn)了應(yīng)用程序基本框架，其中有個小錯誤，在此先跟大家說明下。在“屬性”選項卡中，我們當時添加的是DataGridView控件，這個控件是用來顯示

6、數(shù)據(jù)表的，而專門用于屬性的查詢和設(shè)置的控件是PropertyGrid控件。因此請你刪除“屬性”選項卡中的DataGridView控件，再把位于“工具箱|所有Windows窗體PropertyGrid”（如果沒有，右擊選擇“選擇項"以添加此控件）控件拖到該選項卡。在這一講中，主要講解菜單的添加和實現(xiàn)。1、添加菜單在設(shè)計視圖中，單擊菜單欄，會岀現(xiàn)“請在此處鍵入”的提示，單擊提示就可以鍵入菜單名稱，如“文件”，再單擊“文件”，即可輸入其下拉子菜單，如下所示：Tips:每創(chuàng)建一個菜單，請在其屬性面板中設(shè)置Name屬性，而且不要為中文，因此Name值將是此菜單響應(yīng)函數(shù)的函數(shù)名的一部分，帶中文的

7、函數(shù)名，總是不好吧。本講中，我們將添加新建（New）、打開（Open）、添加數(shù)據(jù)（AddData）、保存（Save）、另存為（SaveAs）、退出（Exit）這些菜單，（）內(nèi)為相應(yīng)的Name屬性值。Tips:你可以在屬性面板中的Text屬性中，把菜單名設(shè)置為中英文形式，如“打開0pen”，帶下劃線的0表示此項菜單的快捷鍵是字母0,設(shè)置方法是在相應(yīng)字母前加上“&”字符，如“打開&Open”。但這種快捷鍵只在打開此下拉菜單時才有效，即當你單擊“文件”菜單彈岀下拉菜單時，按下字母0就可以定位到“打開”菜單。還有一種在程序運行時都有效的全局快捷鍵，可以在屬性面板中的“ShortCutK

8、eys"中設(shè)置。你還可以在屬性面板中的Image屬性中設(shè)置你喜歡的菜單圖標。單擊Image那一行右邊的按鈕，彈出如下菜單。選擇“項目資源文件”，再單擊導入就可以選擇你的圖標了。最終效果顯示如下:注意，在解決方案面板中，選中剛才添加的所有圖標，在其屬性面板中將生成操作設(shè)置為“嵌入的資源”，這一點很重要！2、實現(xiàn)相關(guān)菜單首先定義指針(寫在publicpartialclassForml:Form下面即可)：privateESRI.ArcGIS.ControlsMapControl3m_mapControl=null;privateESRI.ArcGIS.ControlsPageLayout

9、Control2m_pageLayoutControl=null;privateIMapDocumentpMapDocument;若以上指針無效，請?zhí)砑右韵乱茫簎singESRI.ArcGIS.Carto;usingESRI.ArcGIS.Controls;usingESRI.ArcGIS.esriSystem;usingESRI.ArcGIS.Display;usingESRI.ArcGIS.Geometry;usingESRI.ArcGIS.SystemUI;在設(shè)計視圖中的屬性面板中，選擇Form1，即主窗體，單擊事件按鈕(閃電形狀的那個按鈕)，打到“Load”事件并雙擊，添加此事件。在

10、Form1_Load函數(shù)中初始化這些指針：/取得MapControl和PageLayoutControl的引用m_mapControl=(IMapControl3)this.axMapControl1.Object;m_pageLayoutControl=(IPageLayoutControl2)this.axPageLayoutControl1.Object;依次雙擊每個菜單項，添加菜單響應(yīng)函數(shù)。實現(xiàn)代碼如下：/<summary>/新建地圖命令/</summary>/<paramname="sender"></param>/

11、<paramname="e"></param>privatevoidNew_Click(objectsender,EventArgse)/本命令涉及到MapControl和PageLayoutControl同步問題，將在下一講中實現(xiàn)/<summary>/打開地圖文檔Mxd命令/</summary>/<paramname="sender"></param>/<paramname="e"></param>privatevoidOpen_Clic

12、k(objectsender,EventArgse)/本命令涉及到MapControl和PageLayoutControl同步問題，將在下一講中實現(xiàn)/<summary>/添加數(shù)據(jù)命令/</summary>/<paramname="sender"></param>/<paramname="e"></param>privatevoidAddData_Click(objectsender,EventArgse)intcurrentLayerCount=this.axMapControl1.

13、LayerCount;ICommandpCommand=newControlsAddDataCommandClass();pCommand.OnCreate(this.axMapControl1.Object);pCommand.OnClick();/<summary>/保存地圖文檔命令/</summary>/<paramname="sender"></param>/<paramname="e"></param>privatevoidSave_Click(objectsender,E

14、ventArgse)/首先確認當前地圖文檔是否有效if(null!=m_pageLayoutControl.DocumentFilename&&m_mapControl.CheckMxFile(m_pageLayoutControl.DocumentFilename)/創(chuàng)建一個新的地圖文檔實例IMapDocumentmapDoc=newMapDocumentClass();/打開當前地圖文檔mapDoc.Open(m_pageLayoutControl.DocumentFilename,string.Empty);/用PageLayout中的文檔替換當前文檔中的PageLayo

15、ut部分mapDoc.ReplaceContents(IMxdContents)m_pageLayoutControl.PageLayout);/保存地圖文檔mapDoc.Save(mapDoc.UsesRelativePaths,false);mapDoc.Close();/<summary>/另存為地圖文檔命令/</summary>/<paramname="sender"></param>/<paramname="e"></param>privatevoidSaveAs_Clic

16、k(objectsender,EventArgse)/調(diào)用另存為命令I(lǐng)Commandcommand=newControlsSaveAsDocCommandClass();command.OnCreate(m_controlsSynchronizer.ActiveControl);command.OnClick();/<summary>/退出程序/</summary>/<paramname="sender"></param>/<paramname="e"></param>private

17、voidExit_Click(objectsender,EventArgse)Application.Exit();3、編譯運行按F5編譯運行程序。也許你會發(fā)現(xiàn)，菜單命令的實現(xiàn)方式都是類型的。沒錯，在AE9.2中，內(nèi)置了許多常用的Command和Tool，如ControlsAddDataCommandClass、ControlsMapZoomInToolClass、ControlsMapPanToolClass等等，這些內(nèi)置對象在ESRI.ArcGIS.Controls命名空間中，你可以對象瀏覽器中查看。而且這些內(nèi)置對象的調(diào)用方式都類似，如下所示：/定義ICommandcommand=newC

18、ontrolsSaveAsDocCommandClass();/創(chuàng)建command.OnCreate(m_controlsSynchronizer.ActiveControl);/調(diào)用command.OnClick();第三講MapControl與PageLayoutControl同步這也是輸入類名在ArcMap中，能夠很方面地進行MapView和LayoutView兩種視圖的切換，而且二者之間的數(shù)據(jù)是同步顯示的。關(guān)于兩種視圖同步的實現(xiàn)方法有多種，可以使用ObjectCopy對象進行數(shù)據(jù)硬拷貝，而比較簡單的方法莫過于二者共享一份地圖了，最常用的方法。1、新建同步類ControlsSynchro

19、nizer在解決方案面板中右擊項目名，選擇“添加|類”，在類別中選擇“VisualC#項目項”，在模板中選擇“類”“ControlsSynchronizer.cs”，將以下代碼覆蓋自動生成的代碼：usingSystem;usingSystem.Drawing;usingSystem.Collections;usingSystem.ComponentModel;usingSystem.Windows.Forms;usingSystem.IO;usingSystem.Runtime.InteropServices;usingESRI.ArcGIS.esriSystem;usingESRI.ArcG

20、IS.Carto;usingESRI.ArcGIS.Controls;usingESRI.ArcGIS.SystemUI;namespace_sdnMap/<summary>/ThisclassisusedtosynchronizeagvenPageLayoutControlandaMapControl./Wheninitialized,theusermustpassthereferenceofthesecontroltotheclass,bind/thecontroltogetherbycalling'BindControls'whichinturnsetsajo

21、inedMapreferenced/bybothcontrol;andsetallthebuddycontrolsjoinedbetweenthesetwocontrols./WhenalternatingbetweentheMapControlandPageLayoutControl,youshouldactivatethevisiblecontrol/anddeactivatetheotherbycallingActivateXXX./Thiscalssislimitedtoasituationwherethecontrolsarenotsimultaneouslyvisible./<

22、;/summary>publicclassControlsSynchronizer#regionclassmembersprivateIMapControl3m_mapControl=null;privateIPageLayoutControl2m_pageLayoutControl=null;privateIToolm_mapActiveTool=null;privateIToolm_pageLayoutActiveTool=null;privateboolm_IsMapCtrlactive=true;privateArrayListm_frameworkControls=null;#

23、endregion#regionconstructor/<summary>/默認構(gòu)造函數(shù)/</summary>publicControlsSynchronizer()/初始化ArrayListm_frameworkControls=newArrayList();/<summary>/構(gòu)造函數(shù)/</summary>/<paramname="mapControl"></param>/<paramname="pageLayoutControl"></param>pu

24、blicControlsSynchronizer(IMapControl3mapControl,IPageLayoutControl2pageLayoutControl):this()/為類成員賦值m_mapControl=mapControl;m_pageLayoutControl=pageLayoutControl;#endregion#regionproperties/<summary>/取得或設(shè)置MapControl/</summary>publicIMapControl3MapControlgetreturnm_mapControl;setm_mapContr

25、ol=value;/<summary>/取得或設(shè)置PageLayoutControl/</summary>publicIPageLayoutControl2PageLayoutControlgetreturnm_pageLayoutControl;setm_pageLayoutControl=value;/<summary>/取得當前ActiveView的類型/</summary>publicstringActiveViewTypegetif(m_IsMapCtrlactive)return"MapControl"elsere

26、turn"PageLayoutControl"/<summary>/取得當前活動的Control/</summary>publicobjectActiveControlMapControlorPageLayoutControlaregetif(m_mapControl=null|m_pageLayoutControl=null)thrownewException("ControlsSynchronizer:ActiveControl:rnEithernotinitialized!");if(m_IsMapCtrlactive)re

27、turnm_mapControl.Object;elsereturnm_pageLayoutControl.Object;#endregion#regionMethods/<summary>/激活MapControl并解除thePagleLayoutControl/</summary>publicvoidActivateMap()tryif(m_pageLayoutControl=null|m_mapControl=null)thrownewException("ControlsSynchronizer:ActivateMap:rnEitherMapContr

28、olorPageLayoutControlarenotinitialized!");/緩存當前PageLayout的CurrentToolif(m_pageLayoutControl.CurrentTool!=null)m_pageLayoutActiveTool=m_pageLayoutControl.CurrentTool;/解除PagleLayoutm_pageLayoutControl.ActiveView.Deactivate();/激活MapControlm_mapControl.ActiveView.Activate(m_mapControl.hWnd);/將之前Map

29、Control最后使用的tool，作為活動的tool，賦給MapControl的CurrentToolif(m_mapActiveTool!=null)m_mapControl.CurrentTool=m_mapActiveTool;m_IsMapCtrlactive=true;/為每一個的frameworkcontrols,設(shè)置Buddycontrol為MapControlthis.SetBuddies(m_mapControl.Object);catch(Exceptionex)thrownewException(string.Format("ControlsSynchroniz

30、er:ActivateMap:rn0",ex.Message);/<summary>/激活PagleLayoutControl并減活MapCotrol/</summary>publicvoidActivatePageLayout()tryif(m_pageLayoutControl=null|m_mapControl=null)orthrownewException("ControlsSynchronizer:ActivatePageLayout:rnEitherMapControlPageLayoutControlarenotinitialized

31、!");/緩存當前MapControl的CurrentToolif(m_mapControl.CurrentTool!=null)m_mapActiveTool=m_mapControl.CurrentTool;/解除MapControlm_mapControl.ActiveView.Deactivate();/激活PageLayoutControlm_pageLayoutControl.ActiveView.Activate(m_pageLayoutControl.hWnd);/將之前PageLayoutControl最后使用的tool，作為活動的tool，賦給PageLayout

32、Control的CurrentToolif(m_pageLayoutActiveTool!=null)m_pageLayoutControl.CurrentTool=m_pageLayoutActiveTool;m_IsMapCtrlactive=false;/為每一個的frameworkcontrols,設(shè)置Buddycontrol為PageLayoutControlthis.SetBuddies(m_pageLayoutControl.Object);catch(Exceptionex)thrownewException(string.Format("ControlsSynchr

33、onizer:ActivatePageLayout:rn0",ex.Message);/<summary>/給予一個地圖,置換PageLayoutControl和MapControl的focusmap/</summary>/<paramname="newMap"></param>publicvoidReplaceMap(IMapnewMap)if(newMap=null)thrownewException("ControlsSynchronizer:ReplaceMap:rnNewmapforreplace

34、mentisnotinitialized!");if(m_pageLayoutControl=null|m_mapControl=null)thrownewException("ControlsSynchronizer:ReplaceMap:rnEitherMapControlorPageLayoutControlarenotinitialized!");/createanewinstanceofIMapscollectionwhichisneededbythePageLayout/創(chuàng)建一個PageLayout需要用到的,新的IMapscollection的實例I

35、Mapsmaps=newMaps();/addthenewmaptotheMapscollection/把新的地圖加到Mapscollection里頭去maps.Add(newMap);boolbIsMapActive=m_IsMapCtrlactive;/callreplacemaponthePageLayoutinordertoreplacethefocusmap/wemustcallActivatePageLayout,sinceitisthecontrolwecall'ReplaceMaps'/調(diào)用PageLayout的replacemap來置換focusmap/我們必

36、須調(diào)用ActivatePageLayout,因為它是那個我們可以調(diào)用"ReplaceMaps"的Controlthis.ActivatePageLayout();m_pageLayoutControl.PageLayout.ReplaceMaps(maps);/assignthenewmaptotheMapControl/把新的地圖賦給MapControlm_mapControl.Map=newMap;/resettheactivetools/重設(shè)activetoolsm_pageLayoutActiveTool=null;m_mapActiveTool=null;/mak

37、esurethatthelastactivecontrolisactivated/確認之前活動的control被激活if(bIsMapActive)this.ActivateMap();m_mapControl.ActiveView.Refresh();elsethis.ActivatePageLayout();m_pageLayoutControl.ActiveView.Refresh();/<summary>/bindtheMapControlandPageLayoutControltogetherbyassigninganewjointfocusmap/指定共同的Map來把M

38、apControl和PageLayoutControl綁在一起/</summary>/<paramname="mapControl"></param>/<paramname="pageLayoutControl"></param>/<paramname="activateMapFirst">trueiftheMapControlsupposedtobeactivatedfirst,如果MapControl被首先激活,則為true</param>publ

39、icvoidBindControls(IMapControl3mapControl,IPageLayoutControl2pageLayoutControl,boolactivateMapFirst)if(mapControl=null|pageLayoutControl=null)thrownewException("ControlsSynchronizer:BindControls:rnEitherMapControlorPageLayoutControlarenotinitialized!");m_mapControl=MapControl;m_pageLayoutC

40、ontrol=pageLayoutControl;this.BindControls(activateMapFirst);/<summary>/bindtheMapControlandPageLayoutControltogetherbyassigninganewjointfocusmap/指定共同的Map來把MapControl和PageLayoutControl綁在一起/</summary>/<paramname="activateMapFirst">trueiftheMapControlsupposedtobeactivatedfi

41、rst,如果MapControl被首先激活,則為true</param>publicvoidBindControls(boolactivateMapFirst)if(m_pageLayoutControl=null|m_mapControl=null)thrownewException("ControlsSynchronizer:BindControls:rnEitherMapControlorPageLayoutControlareinitialized!");/createanewinstanceofIMap/創(chuàng)造IMap的一個實例IMapnewMap=ne

42、wMapClass();newMap.Name="Map"/createanewinstanceofIMapscollectionwhichisneededbythePageLayout/創(chuàng)造一個新的IMapscollection的實例,這是PageLayout所需要的IMapsmaps=newMaps();/addthenewMapinstancetotheMapscollection/把新的Map實例賦給Mapscollectionmaps.Add(newMap);/callreplacemaponthePageLayoutinordertoreplacethefocu

43、smap/調(diào)用PageLayout的replacemap來置換focusmapm_pageLayoutControl.PageLayout.ReplaceMaps(maps);/assignthenewmaptotheMapControl/把新的map賦給MapControlm_mapControl.Map=newMap;/resettheactivetools/重設(shè)activetoolsm_pageLayoutActiveTool=null;m_mapActiveTool=null;/makesurethatthelastactivecontrolisactivated/確定最后活動的con

44、trol被激活if(activateMapFirst)this.ActivateMap();elsethis.ActivatePageLayout();/<summary>/bypassingtheapplication'stoolbarsandTOCtothesynchronizationclass,itsavesyouthe/managementofthebuddycontroleachtimetheactivecontrolchanges.Thismethodadstheframework/controltoanarray;oncetheactivecontrolch

45、anges,theclassiteratesthroughthearrayand/callesSetBuddyControloneachofthestoredframeworkcontrol./</summary>/<paramname="control"></param>publicvoidAddFrameworkControl(objectcontrol)if(control=null)thrownewException("ControlsSynchronizer:AddFrameworkControl:rnAddedcon

46、trolisnotinitialized!");m_frameworkControls.Add(control);/<summary>/Removeaframeworkcontrolfromthemanagedlistofcontrols/</summary>/<paramname="control"></param>publicvoidRemoveFrameworkControl(objectcontrol)if(control=null)thrownewException("ControlsSynchr

47、onizer:RemoveFrameworkControl:rnControltoberemovedisinitialized!");m_frameworkControls.Remove(control);/<summary>/Removeaframeworkcontrolfromthemanagedlistofcontrolsbyspecifyingitsindexinthelist/</summary>notnot/<paramname="index"></param>publicvoidRemoveFramew

48、orkControlAt(intindex)if(m_frameworkControls.Count<index)thrownewException("ControlsSynchronizer:RemoveFrameworkControlAt:rnIndexisoutofrange!");m_frameworkControls.RemoveAt(index);/<summary>/whentheactivecontrolchanges,theclassiteratesthroughthearrayoftheframeworkcontrols/andcall

49、esSetBuddyControloneachofthecontrols./</summary>/<paramname="buddy">theactivecontrol</param>privatevoidSetBuddies(objectbuddy)tryif(buddy=null)thrownewException("ControlsSynchronizer:SetBuddies:rnTargetBuddyControlisnotinitialized!");foreach(objectobjinm_framewo

50、rkControls)if(objisIToolbarControl)(IToolbarControl)obj).SetBuddyControl(buddy);elseif(objisITOCControl)(ITOCControl)obj).SetBuddyControl(buddy);catch(Exceptionex)ThrownewException(string.Format("ControlsSynchronizer:SetBuddies:rn0",ex.Message);#endregion2、新建Maps類在同步類中，要用到Maps類，用于管理地圖對象。與新建同步類ControlsSynchronizer類似，我們新建一Maps類，其所有代碼如下所示:usingSystem;usingSystem.Collections;usingSystem.Collections.Generic;usingSystem.Text;usingSystem.Runtime.InteropServices;usingESRI.ArcGIS.Carto;namespace_sdnMapGuid("f27d8789-fbbc-4801-be78-0e3c