GIS應用開發(fā)5-ArcEngine常用控件解讀課件

制圖控件應用開發(fā)

ArcGISEngine控件制圖控件和對象框架控件命令和工具管理地圖文檔課4概述ArcGISEngine總覽制圖控件:MapControl

和PageLayoutControl框架控件:TOCControl

和ToolbarControlReaderControl:ReaderControl所有控件都是通過Carto來訪問ArcObjectsArcGISEngine控件控件為開發(fā)者提供了一個開發(fā)的框架封裝了ArcObjects

的功能使用propertypages易于快速入門設置伙伴控件訪問數(shù)據(jù)加載命令和工具開始使用控件

MapControl封裝MapcoClass繪制單DataFrame用來分析和瀏覽暴露鼠標和繪制事件裝載地圖文檔和其它文件設置當前工具庫MapControl.ocxMapControl控件MapControl對應于ArcMap中的數(shù)據(jù)視圖，它封裝了Map對象，并提供了額外的屬性、方法、事件用于：管理控件的外觀、顯示屬性和地圖屬性；添加并管理控件中的數(shù)據(jù)層（datalayers）；裝載Map文檔（mxd）到控件中；從其它應用程序拖放數(shù)據(jù)到控件中；trackingshapesanddrawingtothedisplay.在可視化環(huán)境中，可以通過控件的“屬性”頁設置控件的相關屬性，也可以通過編程來設置。MapControl控件

PageLayoutControl封裝PageLayout

coclass繪制地圖元素創(chuàng)建版面視圖打印設置當前工具加載地圖文檔庫PageLayoutControl.ocxPageLayoutControl控件IMapControl3/IPageLayoutControl2CheckMxFileLoadMxFileReadMxMaps制圖控件:數(shù)據(jù)訪問privatevoidLoadMapDocument(){ openFileDialog2.Title="OpenMapDocument";

openFileDialog2.Filter="MapDocuments(*.mxd)|*.mxd"; openFileDialog2.ShowDialog(); stringsFilePath=openFileDialog2.FileName;

if(axMapControl1.CheckMxFile(sFilePath)) { axMapControl1.LoadMxFile(sFilePath,0,Type.Missing); }

else { MessageBox.Show(sFilePath+"isnotavalidArcMapdocument"); return; } }

制圖控件:事件IMapControlEvents2是一個事件接口，它定義了MapControl能夠處理的全部事件，如OnExtentUpdated是地圖的Extent屬性發(fā)生變化時觸發(fā)的事件，

OnAfterscreenDraw是繪屏結束后觸發(fā)的事件等。

當?shù)貓D的覆蓋范圍變化時，觸發(fā)OnFullExtentUpdated

事件，例如，往地圖中新增加一個圖層，其覆蓋范圍大于原圖的范圍。通過Map你可以訪問所有的對象LayersRenderersSymbolsFeatureClassesWorkspacesMapControl

對象提供直接訪問Map和Layer對象的方法屬性IMapControl3AddLayerFromFile,AddShapeFile,AddLayer,DeleteLayer,MoveLayerTo,Layer,Map使用map和layers屬性簡化和地圖相互作用的成員

IMapControl3Drawshape,Flashshape,DrawText,TrackCircle,TrackLine,TrackPolygon,TrackRectangle使用MapControl控件的顯示函數(shù)控制顯示的可視區(qū)域可以設置多種shapes(geometries)IMapControl3

VisibleRegion設置地圖的可視區(qū)可以為圖層設置提示步驟1.

設置ILayer::ShowTips2.在鼠標移動時顯示提示文本使用ToolTip控件來顯示提示在地圖上顯示提示（tips）使用PageLayout

來訪問其它對象Elements(例子代碼MapElements)FrameElementsMapFrameMapSurroundFrameGraphicElementsPictureElementsPageLayoutControl對象關于elements有很多高級的成員函數(shù)IPageLayoutControlAddElementFindElementByNameLocateFrontElementGraphicsContainer使用elements使用SelectionTracker

來顯示elements兩步選擇元素繪制OnAfterDraw顯示選擇的elementsIPageLayoutControl2PagePrinterPrinterPageCountPrintPageLayout打印版面視圖MXD文件是結構化的存儲文檔通常由ArcMap創(chuàng)建包含持久對象Maps,Layers,PageLayout,…MapDocument

使以下成為可能讀取mxd,lyr,mxt,andpmffiles寫新的mxdfiles訪問mapdocument的內容使用地圖文檔讀取和寫地圖文檔的成員函數(shù)Open:打開已經(jīng)存在的地圖文檔(mxd,mxt,lyr,pmf)SaveAs:保存當前文檔到新的文件讀取和寫地圖文檔的成員函數(shù)New:用給定的名稱（mxd）創(chuàng)建地圖文檔Save:保存內容到當前文檔IMapDocument:打開和保存IMapDocument:新建和保存控件可以直接引用對象(MapandPageLayout)或訪問自己的拷貝Reference直接Copy使用ObjectCopy

避免共享引用深度復制訪問地圖文檔中的對象要設置地圖文檔的屬性，必須替換Map和/或PageLayout

對象當你想要存儲當前所做的修改時調用VisibilityExtentSymbology在MapDocument中替換內容框架控件

ToolbarControl

和TOCControl

被設計成和其它控件協(xié)同工作通過一個buddy控件自動捆綁在一起根據(jù)彼此的狀態(tài)通信和同步例子:activetool,layervisibility顯示所有的圖層和符號Simplesymbols,renderersGrouplayers控制圖層可視性必須調用SetBuddyControl庫TOCControl.ocxTOCControlTOCControl

屬性Buddy,SetBuddyControl,SetActiveViewLabelEdit，LayerVisibilityEdit：默認是自動的MousePointerITOCControl

成員LabelingMousemoveKeypressHitTestX和Y鼠標位置ItemTypeBasicMapLayerUnk:ILegendGroupData:LegendclassindexTOCControl

事件自定義commands,tools和menus的容器允許命令和以下控件對象進行交互Map,PageLayout,Scene,和Globe必須調用SetBuddyControl庫ToolbarControl.ocxToolbarControl使用函數(shù)HitTest

來查詢點擊的工具項鼠標事件OnMouseDownOnMouseUpOnMouseMoveOnDoubleClick鍵盤事件OnKeyDown

和OnKeyUp按鈕和工具事件OnItemClickOnDoubleClickIToolbarControl

事件系統(tǒng)提供的控件命令,工具,工具條,和菜單命令和工具漫游,縮放,打開地圖,圖形繪制,…工具條要素選擇,繪圖,地圖導航,和pagelayout菜單要素選擇和地圖瀏覽庫esriCommandControls.olb參考對象模型圖或技術文檔框架控件命令三種方式創(chuàng)建一個新的實例使用ProgID

字符串創(chuàng)建并定義一個UID(傳入ProgID

或CLSID參數(shù))可以在技術文檔“ControlsCommands”找到內置的命令,菜單,和工具條加載內置的命令,菜單和工具條三方法AddItem,AddToolbarDefAddMenuItem多參數(shù)UID,subtype,index,begingroup,groupspacing,style加載項的不同方法ArcReaderControl屬于ArcGISDesktop需要有ArcGISPublisherextension才能使用能構建和分發(fā)獨立應用程序需要安裝ArcReaderReaderControl屬于ArcGISEngine需要ArcGISEngineRuntimeArcReaderControlvs.ReaderControl控件的定制和擴展

ToolbarControl

框架定制命令和工具定制COM命令,工具,工具條,和菜單定制COM擴展定制對話框

ToolbarMenus課5概述定制和擴展的類型可以有多種不同定制方法允許用戶在運行時增加和移除命令（通過CustomizeDialog）自動保存和加載命令到工具條上運行時創(chuàng)建和顯示菜單可以實現(xiàn)不同的擴展創(chuàng)建定制的命令,工具,菜單,和工具條定制擴展ToolbarControlToolbarItemsCommandPoolToolBarMenuToolbarItemsCommandPoolCustomizeDialogToolbarControl

框架

ToolbarControl

為每一個加載的項創(chuàng)建一個ToolbarItem類用于管理相應的項目項目類別命令,工具,工具控件,和工具條菜單ToolbarItems工具條項目管理命令的集合只有兩個對象直接訪問命令池ToolbarControlToolbarMenu

提供低水平的訪問ICommandPool::CreatedICommandPool::ExistsICommandPoolEdit::CallOnCreateICommandPoolEdit::Hook

開發(fā)者通常不使用CommandPool命令池方法1:傳遞一個新命令對象的實例NewCommandItemiscreatedforthisobjectNotshared方法2:傳遞命令的UIDNewCommandItemiscreatedifitdoesnotexistAllreferenceswillsharetheinstance項目怎樣被加載到命令池中ToolbarItems

封裝了commandsIToolbarItemCommand:提供對command的訪問Style:控制command的風格UID:command的全局唯一ID號ToolbarItems

和CommandsDimtoolbarItemAsIToolbarItem

Fori=0ToAxToolbarControl1.Count-1

toolbarItem=AxToolbarControl1.GetItem(i)

DimcommandasICommand

command=toolbarItem.Commanda

MsgBox(command.Name&toolbarItem.Style&toolbarItem.UID.Value)

Next框架提供了創(chuàng)建自定義command的機制無縫地加載到ToolbarControl作為一個CommandItem

加載外觀和行為和其它項一樣執(zhí)行任何ArcObjects

代碼步驟1.創(chuàng)建一個類2.實現(xiàn)ICommand3.將類加載到工具條上實現(xiàn)定制命令當command被創(chuàng)建屬性就可存取屬性

ICommandNameCaptionCategoryTooltipMessageBitmapHelpContextHelpFile定制命令:屬性設置DimcommandasICommand=NewesriControlCommands.ControlsMapZoomInToolToolbarControl1.AddItemcommand,0,-1,True,,esriCommandStyleIconA