(整理)ArcGIS_Engine+C#實例開發(fā)教程+添加標注.

1、本講主要是使用立起根本的桌面第一講桌面GIS應用程序框架的建立MapControl、PageLayoutControl、ToolbarControl、TOCControl四個控件建GIS應用程序框架.最終成果預覽如下：1、新建工程啟動VS2005,選擇“文件|新建|工程,在工程類型中選擇VisualC#,再選擇Windows應用程序模板,輸入名稱“3sdnMap,點擊確定.在解決方案治理器中將“Form1.cs"重命名為"3sdnMap.cs,在設計視圖中,選中窗體,將其屬性中的“Text改為“3sdnMap.2、添加控件選擇工具箱中的“菜單和工具欄|MenuStrip,將

2、其拖入窗體.選擇工具有i中的"ArcGISWindowsForms"節(jié),將"ToolbarControl控件拖入窗體,并將其屬性中的Dock設置為Top.選擇工具箱中的“菜單和工具欄|StatusStrip,將其拖入到窗體.選擇工具箱中的“容器|SplitContainer容器拖入窗體,并將其屬性中的Dock設置為Fillo將TabControl控件拖入Panel1,將Alignment屬性設置為Bottom,Dock屬性設置為Fill.點擊TabPages屬性右邊的按鈕,彈出TabPage集合編輯器,將tabPage1的Name設置為tabPageLayer,T

3、ext設置為圖層,將tabPage2的Name設置為tabPageProperty,Text設置為屬性.如下所示.選擇“圖層選項卡,拖入TOCControl控件,設置Dock屬性為Fill.選擇“屬性選項卡,拖入DataGridView控件,設置Dock屬性為Fill.拖入TabControl控件到Panel2,設置Dock屬性為Fillo并上述類似的方法,將兩個選項卡的Name和Text分另1J設置為：tabPageMap、地圖,tabPageLayout,制版.選擇“地圖選項卡,拖入MapControl控件,設置Dock屬性為Fillo選擇"制版"選項卡,拖入PageL

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

5、eneric,雙擊Open、SaveAs、Redo、Undo即可將相應工具添加到工具條.常見的工具有：MapNavigation中的導航工具,MapInquiry中的查詢工具,FeatureSelection中的選擇工具,你可以根據(jù)需要酌情添加工具.5、編譯運行按F5即可編譯運行程序,至此桌面GIS應用程序框架根本框架已經(jīng)搭建好了,你可以通過工具條的工具翻開地圖文檔,瀏覽地圖了,效果如開篇所示.下一講中將大家?guī)淼氖遣藛蔚奶砑蛹捌鋵崿F(xiàn),敬請關注3SDN.NET.第二講菜單的添加及其實現(xiàn)在上一講中,我們實現(xiàn)了應用程序根本框架,其中有個小錯誤,在此先跟大家說明下.在“屬性選項卡中,我們當時添加的是

6、DataGridView控件,這個控件是用來顯示數(shù)據(jù)表的,而專門用于屬性的查詢和設置的控件是PropertyGrid控件.因此請你刪除“屬性選項卡中的DataGridView控件,再把位于“工具箱|所有Windows窗體|PropertyGrid"如果沒有,右擊選擇“選擇項以添加此控件控件拖到該選項卡.在這一講中,主要講解菜單的添加和實現(xiàn).1、添加菜單請在此處鍵入1Tips在設計視圖中,單擊菜單欄,會出現(xiàn)“請在此處鍵入的提示,單擊提示就可以鍵入菜單名稱,如“文件,再單擊“文件,即可輸入其下拉子菜單,如下所示：SS版工ioTlArcGlSEngineName:axMapC每創(chuàng)立一個菜單

7、,請在其屬性面板中設置Name屬性,而且不要為中文,因此Name值將是此菜單響應函數(shù)的函數(shù)名的一局部,帶中文的函數(shù)名,總是不好吧.本講中,我們將添加新建New、翻開Open、添加數(shù)據(jù)AddData、保存Save、另存為SaveAs、退出Exit這些菜單,內為相應的Name屬性值.Tips:你可以在屬性面板中的Text屬性中,把菜單名設置為中英文形式,如“翻開Open,帶下劃線的O表示此項菜單的快捷鍵是字母O,設置方法是在相應字母前加上“&字符,如“翻開&Open.但這種快捷鍵只在翻開此下拉菜單時才有效,即當你單擊“文件菜單彈出下拉菜單時,按下字母O就可以定位到“翻開菜單.還有一

8、種在程序運行時都有效的全局快捷鍵,可以在屬性面板中的"ShortCutKeys中設置.你還可以在屬性面板中的Image屬性中設置你喜歡的菜單圖標.單擊Image那一行右邊的按鈕,彈出如下菜單.選擇“工程資源文件,再單擊導入就可以選擇你的圖標了.選擇萱源資遮上下文C本地資源:工程資源文件最終效果如下所示.新建New話在此處ontrol制版地圖ArcGISErame:;翻開Qp&n添加數(shù)據(jù)AddBata保存Savs另存為SavaAs退出ExitF稔,.1,二,工：lemurimnramramiamsmaBiniBiinir注意,在解決方案面板中,選中剛剛添加的所有圖標,在其屬性面

9、板中將生成操作設置為“嵌入的資源,這一點很重要！2、實現(xiàn)相關菜單首先定義指針寫在publicpartialclassForml:Form下面即可privateESRI.ArcGIS.Controls.IMapControl3mmapControl=null;privateESRI.ArcGIS.Controls.IPageLayoutControl2m_pageLayoutControl=null;privateIMapDocumentpMapDocument;假設以上指針無效,請?zhí)砑右韵乱茫簎singESRI.ArcGIS.Carto;usingESRI.ArcGIS.Controls;u

10、singESRI.ArcGIS.esriSystem;usingESRI.ArcGIS.Display;usingESRI.ArcGIS.Geometry;usingESRI.ArcGIS.SystemUI;在設計視圖中的屬性面板中,選擇Form1,即主窗體,單擊事件按鈕(閃電形狀的那個按鈕),打到“Load事件并雙擊,添加此事件.在Form1_Load函數(shù)中初始化這些指針：/取得MapControl和PageLayoutControl的引用m_mapControl=(IMapControl3)this.axMapControl1.Object;m_pageLayoutControl=(IPa

11、geLayoutControl2)this.axPageLayoutControl1.Object;依次雙擊每個菜單項,添加菜單響應函數(shù).實現(xiàn)代碼如下：/<summary>/新建地圖命令/</summary>/<paramname="sender"></param>/<paramname="e"></param>privatevoidNew_Click(objectsender,EventArgse)/本命令涉及到MapControl和PageLayoutControl同步問題,將在

12、下一講中實現(xiàn)/<summary>/翻開地圖文檔Mxd命令/</summary>/<paramname="sender"></param>/<paramname="e"></param>privatevoidOpen_Click(objectsender,EventArgse)/本命令涉及到MapControl和PageLayoutControl同步問題,將在下一講中實現(xiàn)/<summary>/添加數(shù)據(jù)命令/</summary>/<paramname=&qu

13、ot;sender"></param>/<paramname="e"></param>privatevoidAddData_Click(objectsender,EventArgse)(intcurrentLayerCount=this.axMapControl1.LayerCount;ICommandpCommand=newControlsAddDataCommandClass();pCommand.OnCreate(this.axMapControl1.Object);pCommand.OnClick();/<s

14、ummary>/保存地圖文檔命令/</summary>/<paramname="sender"></param>/<paramname="e"></param>privatevoidSave_Click(objectsender,EventArgse)(/首先確認當前地圖文檔是否有效&&if(null!=m_pageLayoutControl.DocumentFilenamem_mapControl.CheckMxFile(m_pageLayoutControl.Docum

15、entFilename)(/創(chuàng)立一個新的地圖文檔實例IMapDocumentmapDoc=newMapDocumentClass();/翻開當前地圖文檔mapDoc.Open(m_pageLayoutControl.DocumentFilename,string.Empty);/用PageLayout中的文檔替換當前文檔中的PageLayout局部mapDoc.ReplaceContents(IMxdContents)m_pageLayoutControl.PageLayout);/保存地圖文檔mapDoc.Save(mapDoc.UsesRelativePaths,false);mapDoc

16、.Close();/<summary>/另存為地圖文檔命令/</summary>/<paramname="sender"></param>/<paramname="e"></param>privatevoidSaveAs_Click(objectsender,EventArgse)(/調用另存為命令ICommandcommand=newControlsSaveAsDocCommandClass();command.OnCreate(m_controlsSynchronizer.Act

17、iveControl);command.OnClick();/<summary>/退出程序/</summary>/<paramname="sender"></param>/<paramname="e"></param>privatevoidExit_Click(objectsender,EventArgse)Application.Exit();3、編譯運行按F5編譯運行程序.也許你會發(fā)現(xiàn),菜單命令的實現(xiàn)方式都是類型的.沒錯,在AE9.2中,內置了許多常用的Command和Tool,

18、如ControlsAddDataCommandClass、ControlsMapZoomInToolClass、ControlsMapPanToolClass等等,這些內置對象在ESRI.ArcGIS.Controls命名空間中,你可以對象瀏覽器中查看.而且這些內置對象的調用方式都類似,如下所示：/定義ICommandcommand=newControlsSaveAsDocCommandClass();/創(chuàng)立command.OnCreate(m_controlsSynchronizer.ActiveControl);/調用command.OnClick();希望你可以舉一反三,去實現(xiàn)更多的你想

19、要的功能.在下一講中,我將給大家?guī)淼氖荕apControl與PageLayoutControl兩種視圖同步的實現(xiàn),敬請關注3SDN.NET.第三講MapControl與PageLayoutControl同步在ArcMap中,能夠很方面地進行MapView和LayoutView兩種視圖的切換,而且二者之間的數(shù)據(jù)是同步顯示的.關于兩種視圖同步的實現(xiàn)方法有多種,可以使用ObjectCopy對象進行數(shù)據(jù)硬拷貝,而比擬簡單的方法莫過于二者共享一份地圖了,這也是最常用的方法.1、新建同步類ControlsSynchronizer在解決方案面板中右擊工程名,選擇“添加|類,在類別中選擇“VisualC#工

20、程項",在模板中選擇“類,輸入類名“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;u

21、singESRI.ArcGIS.SystemUI;namespace_sdnMap/<summary>/ThisclassisusedtosynchronizeagvenPageLayoutControlandaMapControl./Wheninitialized,theusermustpassthereferenceofthesecontroltotheclass,bind/thecontroltogetherbycalling'BindControls'whichinturnsetsajoinedMapreferenced/bybothcontrol;ands

22、etallthebuddycontrolsjoinedbetweenthesetwocontrols./WhenalternatingbetweentheMapControlandPageLayoutControl,youshouldactivatethevisiblecontrol/anddeactivatetheotherbycallingActivateXXX./Thiscalssislimitedtoasituationwherethecontrolsarenotsimultaneouslyvisible./</summary>publicclassControlsSync

23、hronizer#regionclassmembersprivateIMapControl3m_mapControl=null;privateIPageLayoutControl2m_pageLayoutControl=null;privateIToolm_mapActiveTool=null;privateIToolm_pageLayoutActiveTool=null;privateboolm_IsMapCtrlactive=true;privateArrayListm_frameworkControls=null;#endregion#regionconstructor/<summ

24、ary>/默認構造函數(shù)/</summary>publicControlsSynchronizer()初始化ArrayListm_frameworkControls=newArrayList();/<summary>/構造函數(shù)/</summary>/<paramname="mapControl"></param>/<paramname="pageLayoutControl"></param>publicControlsSynchronizer(IMapControl3

25、mapControl,IPageLayoutControl2pageLayoutControl):this()為類成員賦值m_mapControl=mapControl;m_pageLayoutControl=pageLayoutControl;#endregion#regionproperties/<summary>/取得或設置MapControl/</summary>publicIMapControl3MapControlgetreturnm_mapControl;setm_mapControl=value;/<summary>/取得或設置PageLay

26、outControl/</summary>publicIPageLayoutControl2PageLayoutControlgetreturnm_pageLayoutControl;setm_pageLayoutControl=value;/<summary>/取得當前ActiveView的類型/</summary>publicstringActiveViewTypegetif(m_IsMapCtrlactive)return"MapControl"elsereturn"PageLayoutControl")III&

27、lt;summary>III取得當前活動的ControlIII<Isummary>publicobjectActiveControl(get(if(m_mapControl=null|m_pageLayoutControl=null)thrownewException("ControlsSynchronizer:ActiveControl:rnEitherMapControlorPageLayoutControlarenotinitialized!");if(m_IsMapCtrlactive)returnm_mapControl.Object;elser

28、eturnm_pageLayoutControl.Object;)#endregion#regionMethodsIII<summary>III激活MapControl并解除thePagleLayoutControlIII<Isummary>publicvoidActivateMap()(try(if(m_pageLayoutControl=null|m_mapControl=null)thrownewException("ControlsSynchronizer:ActivateMap:rnEitherMapControlorPageLayoutContro

29、larenotinitialized!");緩存當前PageLayout的CurrentToolif(m_pageLayoutControl.CurrentTool!=null)m_pageLayoutActiveTool=m_pageLayoutControl.CurrentTool;解除PagleLayoutm_pageLayoutControl.ActiveView.Deactivate();II激活MapControlm_mapControl.ActiveView.Activate(m_mapControl.hWnd);將之前MapControl最后使用的tool,作為活動的

30、tool,賦給MapControl的CurrentToolif(m_mapActiveTool!=null)m_mapControl.CurrentTool=m_mapActiveTool;m_IsMapCtrlactive=true;為每一個的frameworkcontrols,設置Buddycontrol為MapControlthis.SetBuddies(m_mapControl.Object);catch(Exceptionex)thrownewException(string.Format("ControlsSynchronizer:ActivateMap:rn0"

31、;,ex.Message);/<summary>/激活PagleLayoutControl并減活MapCotrol/</summary>publicvoidActivatePageLayout()tryif(m_pageLayoutControl=null|m_mapControl=null)thrownewException("ControlsSynchronizer:ActivatePageLayout:rnEitherMapControlorPageLayoutControlarenotinitialized!");緩存當前MapControl

32、的CurrentToolif(m_mapControl.CurrentTool!=null)m_mapActiveTool=m_mapControl.CurrentTool;解除MapControlm_mapControl.ActiveView.Deactivate();激活PageLayoutControlm_pageLayoutControl.ActiveView.Activate(m_pageLayoutControl.hWnd);將之前PageLayoutControl最后使用的tool,作為活動的tool,賦給PageLayoutControl的CurrentToolif(m_pag

33、eLayoutActiveTool!=null)m_pageLayoutControl.CurrentTool=m_pageLayoutActiveTool;m_IsMapCtrlactive=false;為每個的frameworkcontrols,設置Buddycontrol為PageLayoutControlthis.SetBuddies(m_pageLayoutControl.Object);catch(Exceptionex)thrownewException(string.Format("ControlsSynchronizer:ActivatePageLayout:rn0

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

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

36、maptotheMapscollection/把新的地圖加到Mapscollection里頭去maps.Add(newMap);boolbIsMapActive=m_IsMapCtrlactive;/callreplacemaponthePageLayoutinordertoreplacethefocusmap/wemustcallActivatePageLayout,sinceitisthecontrolwecall'ReplaceMaps'調用PageLayout的replacemap來置換focusmap/我們必須調用ActivatePageLayout,由于它是那個我們

37、可以調用"ReplaceMaps"的Controlthis.ActivatePageLayout();m_pageLayoutControl.PageLayout.ReplaceMaps(maps);/assignthenewmaptotheMapControl/把新的地圖賦給MapControlm_mapControl.Map=newMap;/resettheactivetools/重設activetoolsm_pageLayoutActiveTool=null;m_mapActiveTool=null;/makesurethatthelastactivecontroli

38、sactivated確認之前活動的control被激活if(bIsMapActive)this.ActivateMap();m_mapControl.ActiveView.Refresh();elsethis.ActivatePageLayout();m_pageLayoutControl.ActiveView.Refresh();/<summary>/bindtheMapControlandPageLayoutControltogetherbyassigninganewjointfocusmap/指定共同的Map來把MapControl和PageLayoutControl綁在一起

39、/</summary>/<paramname="mapControl"></param>/<paramname="pageLayoutControl"></param>/<paramname="activateMapFirst">trueiftheMapControlsupposedtobeactivatedfirst,如果MapControl被首先激活,貝U為true</param>publicvoidBindControls(IMapControl

40、3mapControl,IPageLayoutControl2pageLayoutControl,boolactivateMapFirst)if(mapControl=null|pageLayoutControl=null)thrownewException("ControlsSynchronizer:BindControls:rnEitherMapControlorPageLayoutControlarenotinitialized!");m_mapControl=MapControl;m_pageLayoutControl=pageLayoutControl;this.

41、BindControls(activateMapFirst);/<summary>/bindtheMapControlandPageLayoutControltogetherbyassigninganewjointfocusmapIII指定共同的Map來把MapControl和PageLayoutControl綁在一起/<Isummary>III<paramname="activateMapFirst">trueiftheMapControlsupposedtobeactivatedfirst,如果MapControl被首先激活,貝U為t

42、rue<Iparam>publicvoidBindControls(boolactivateMapFirst)(if(m_pageLayoutControl=null|m_mapControl=null)thrownewException("ControlsSynchronizer:BindControls:rnEitherMapControlorPageLayoutControlarenotinitialized!");IIcreateanewinstanceofIMapII創(chuàng)造IMap的一個實例IMapnewMap=newMapClass();newMap.

43、Name="Map"IIcreateanewinstanceofIMapscollectionwhichisneededbythePageLayoutII創(chuàng)造一個新的IMapscollection的實例,這是PageLayout所需要的IMapsmaps=newMaps();IIaddthenewMapinstancetotheMapscollectionII把新的Map實例賦給Mapscollectionmaps.Add(newMap);IIcallreplacemaponthePageLayoutinordertoreplacethefocusmap調用PageLayo

44、ut的replacemap來置換focusmapm_pageLayoutControl.PageLayout.ReplaceMaps(maps);IIassignthenewmaptotheMapControlII把新的map賦給MapControlm_mapControl.Map=newMap;IIresettheactivetoolsII重設activetoolsm_pageLayoutActiveTool=null;m_mapActiveTool=null;IImakesurethatthelastactivecontrolisactivated確定最后活動的control被激活if(a

45、ctivateMapFirst)this.ActivateMap();elsethis.ActivatePageLayout();)III<summary>/bypassingtheapplication'stoolbarsandTOCtothesynchronizationclass,itsavesyouthe/managementofthebuddycontroleachtimetheactivecontrolchanges.Thismethodadstheframework/controltoanarray;oncetheactivecontrolchanges,th

46、eclassiteratesthroughthearrayand/callesSetBuddyControloneachofthestoredframeworkcontrol./</summary>/<paramname="control"></param>publicvoidAddFrameworkControl(objectcontrol)if(control=null)thrownewException("ControlsSynchronizer:AddFrameworkControl:rnAddedcontrolisno

47、tinitialized!");m_frameworkControls.Add(control);/<summary>/Removeaframeworkcontrolfromthemanagedlistofcontrols/</summary>/<paramname="control"></param>publicvoidRemoveFrameworkControl(objectcontrol)if(control=null)thrownewException("ControlsSynchronizer:R

48、emoveFrameworkControl:rnControltoberemovedisnotinitialized!");m_frameworkControls.Remove(control);/<summary>/Removeaframeworkcontrolfromthemanagedlistofcontrolsbyspecifyingitsindexinthelist/</summary>/<paramname="index"></param>publicvoidRemoveFrameworkControlA

49、t(intindex)if(m_frameworkControls.Count<index)thrownewException("ControlsSynchronizer:RemoveFrameworkControlAt:rnIndexisoutofrange!");m_frameworkControls.RemoveAt(index);)III<summary>IIIwhentheactivecontrolchanges,theclassiteratesthroughthearrayoftheframeworkcontrolsIIIandcallesSe

50、tBuddyControloneachofthecontrols.III<Isummary>III<paramname="buddy">theactivecontrol<Iparam>privatevoidSetBuddies(objectbuddy)(try(if(buddy=null)thrownewException("ControlsSynchronizer:SetBuddies:rnTargetBuddyControlisnotinitialized!");foreach(objectobjinm_frame

51、workControls)(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類,用于治理

52、地圖對象.與新建同步類ControlsSynchronizer類似,我們新建一Maps類,其所有代碼如下所示：usingSystem;usingSystem.Collections;usingSystem.Collections.Generic;usingSystem.Text;usingSystem.Runtime.InteropServices;usingESRI.ArcGIS.Carto;namespace_sdnMapGuid("f27d8789-fbbc-4801-be78-0e3cd8fff9d5")ClassInterface(ClassInterfaceTy

53、pe.None)ProgId("_sdnMap.Maps")publicclassMaps:IMaps,IDisposable/classmember-usinginternallyanArrayListtomanagetheMapscollectionprivateArrayListm_array=null;#regionclassconstructorpublicMaps()m_array=newArrayList();#endregion#regionIDisposableMembers/<summary>/Disposethecollection/<

54、;/summary>publicvoidDispose()if(m_array!=null)m_array.Clear();m_array=null;#endregion#regionIMapsMembers/<summary>/RemovetheMapatthegivenindex/</summary>III<paramname="Index"></param>publicvoidRemoveAt(intIndex)(if(Index>m_array.Count|Index<0)thrownewExcept

55、ion("Maps:RemoveAt:rnIndexisoutofrange!");m_array.RemoveAt(Index);III<summary>IIIResettheMapsarrayIII<Isummary>publicvoidReset()(m_array.Clear();III<summary>IIIGetthenumberofMapsinthecollectionIII<Isummary>publicintCount(get(returnm_array.Count;III<summary>IIIReturntheMapatthegivenindexIII<Isummary>III<paramname="Index"><Iparam>III<returns><Ireturns>publicIMapg