PIENET-SDK插件式二次開發(fā)文檔

1、PIE.NET-SDK插件式二次開發(fā)文檔一PIE.Net開發(fā)環(huán)境部署開發(fā)環(huán)境部署確保Win7系統(tǒng)已安裝SP1安裝VisualStudio2013(支持VS2010/2012/2013/2015)安裝PIESDK.exe二次開發(fā)包的A版本2.【SDK】安裝后目錄說明Bin2017/2/151517文怯Config2017/2/15IS：ISData2017/2/1515:17文磁Document2017/2/1515:17文些JjjLanguage2017/2/1515:17Rs-s2017/2/151517G-ample2017/2/1515:1.7文磁S-tyle2017/2/151511.

2、7Template2017/2/1515:1.7文傑Bin開發(fā)包Config配置文件Data坐標系投影及數(shù)據(jù)映射表Document幫助文件Language語言國際化Res按鈕圖標及鼠標Cursor樣式Sample實例文件Style符號庫文件Template$0圖模板檢驗PIEApplication.exe是否可用！二PIE.Net-SDK插件式開發(fā)步驟1.新建工程1.1新建項目WitinJtWW旦加同iFd彎呷辛*牌禪鼻*.即1砂圖2-1:新建項目圖2-2:新建項目注意項目框架選擇.NETFramework4,按上圖紅色框選擇新建項目。項目屬性配置，保持與SDK開發(fā)包一致程序應(yīng)用平臺配置Can

3、tralEle-rt-MicrowlVkhsIS&idioi5.1文聞彬冃楓雷則QT5AS5D(冋冃問生帛回宙武回|Rdeas|血Oebvs站1亡匕號詩注”圖2-3:配置管理器點擊下拉箭頭選擇配置管理器按鈕。圖2-4:配置管理器圖2-8:配置輸出路徑活軸矢方室晅項目SJS平臺生戌轄PIESOKUesfDebug|t|xS6匚|圈項目上下丈遠走要生翻綻蔭的項目囲聖I:圖2-5:配置管理器按如圖2-4、圖2-5所示，分別配置debug/release的活動解決方案平臺為x86；應(yīng)用程序目標框架及生成路徑配置鶴ConrralslME-h/icrasoftVkubI曾11曲口皀理員1女血E.fl4Sl

4、規(guī)因MQT5YAMKTX頃目冋注戍(踰如1匡隊則IMlPM窮SSMfW口溺IMEBJaiHjiBuif*Debjg*jcfei*x.S：Njtee甘的陰罡為恂換I勺sts耀史方甜辟到ei3$.：n；i在惱;罔上至示口:aoto昌NuGetMJ(N)-.設(shè)為啟加目冏SOT)SI收旳牟呂網(wǎng)在交杵當(dāng)眺煙髭匸打開立件旳應(yīng)PSfflR)ExportPrxijfflflIo.psnFilo.圖2-6:項目屬性圖2-7:配置目標框架如方盜吏簡理lfi(dfiM呱堯釋Conlrds.r.r|1醫(yī)CthWllTtilWff電I：3LL&r：Siffl5.l：優(yōu)此ft&ZiontrckTc朮MkrusettVis

5、ualtiudiaiiR文忡;F)制|問Ifl艮M討1HhH1如圖2-6、2-7所示，右鍵打開項目屬性，在【應(yīng)用程序】選項卡中確定目標框架.NetFramework4,輸出類型為類庫。聞CMfokTest-KfiosoftVisualSiudciiBISflj幅舊lifflOQ口門VASEEHSffiSCEJ生盂SWfiJ閔限LMJ工加怕直棗HtQ舸fLM應(yīng)口期翟聞凹OQ洽匕1屮少：且韻”CpMugi通6，聲J*口方1*無INIMIGr-書丘妥面:r廉出沖ttJK迪Ipp皿鼻頑艘因-I$買WLxtocttQg：邙pCkbugYEinPIErCwkolsTMLxiHlB為cm販伽加生Ifi詢+t

6、程賂03S，二3.功能實現(xiàn)3.1添加項目引用ControkTesl-Mieras.ftVisual文忡刃彌舊tKElVJQT5VA1TX頊目世|主成SliM)UfeT)WSS)休瑋1510知幣N)國口DebugSf.夫方據(jù)芟艇苣R?x40、0m丙戶二I琴垢諾6緲5蘭倉話i：匚七I-;)P”G坯方器8打口1、8計，口傘咱目)”匡芯rrtrokTisM冏B引用調(diào))”.渣urn超引冃.苗酋淫HuGet輕污豈時.跟立曲比范圍卜AProDfiinhinnicros-OTT.LHiarpSystemSyslEm.Care-Sysiem.DiatdSysletn.Data.DstaSetExtenion&S

7、slem.DraMingSyBtem.Windows,FoutibSyslem-XmlSystem.Xml.LinqPRmsurce-sPt*DrsviiPoinBEIementTooLc&PC*IMairkerColofCommandControl.tibc*VectorCammand.cs圖2-9:添加引用展開項目目錄樹，右鍵點擊【引用】選擇【添加引用】菜單項。在彈出的引用管理器中點擊【程序集】的【擴展】項下拉選擇。圖2-10:添加引用瀏覽添加上圖紅色框選中的類庫，單擊確定即可。注意：引用項可以根據(jù)自己開發(fā)的插件功能需求進行選擇3.2以加載矢量數(shù)據(jù)為例新建Command命令Confcrd-

8、fcTtMiIMkfOfOfl詁luaJ沁idi您毛劉玄聞邛fl|E|flSiQT5VASSZ5TXES|P|土囲Ej財DSUCDUSfO嗣5|區(qū)昨齊(d曲肋帥囲匚的*Et:HTDebug0X|型-.Eira磚劃罰BlI勻血蔚生碗右左吐BS釜口陶闕宜在忙SB上置說口舷列I=MifGtrlWtiiFih0直力取血月聞相ISS4f：?ara($?Xsinmciri+xXWfeM匕assfiMjC*丘t穴氐SB彌ufT開交甘夬OQ*3|R)觀頰SRShfttAH-bA罔Dj引用叫，田務(wù)弓用絡(luò)，WindersSIXIFl.用戸莊憐m.瞥ai：o.圖2-11:新建類堿D帝血-Cantroklss-t卓如

9、左：St-5PKPVi&ualC*JEDwEjcpr?jvl.2TemplaleOailer-A輔sued3項bWtbiindDwsformsDevEwp日鉆91-4.2ORMPiersirtenlObject埔SUHC#項WP1F弼KBDrExprestvl-4.2RepcrtWizard怕皿甘C*頂站兌辰j(luò)siC#項DevExprestDai&pFXE.XAFTB.C#項R亡p口rringSQL5erver冋Windows璧值埔suHC#項VMdrkfbWuMC#項fEl罔到槪M-wJ3項C#項空尹eVSwaiC#曲ADO.wr-軽WuMC#項EF5.xDbContext三試EE佑Tc#1

10、HJ已左粽VKtDrCmrHand|圖2-12:新建加載矢量命令Hew|IS塊才M眈膽88pQkGhEr0呂囪o#二eclDiCemnindcs*X口艇EControkTr(I啊SEI)廚CiirelTfKPAProaertifrs卜引用k何VcctarDartimdnd.-ts:IfiringFB.Centrei;USJJJKJ.irj.11irW,UElTiSJvjTflT,frSTTTJCufinfiu&lngJVsfflf,j;曬亡即axuFEE,CffintroljT亡-tiiV已dlDtfCbinmanti：1011/-tt-；T；-.1.-I4?ifflpubLc=laz3?Ec

11、torCc-sriand:實現(xiàn)&a強匸ciEinmn堆令CErrdBTaa-MiDraivo-4iViiujI立uu|百豈云）卻4EI期ID理冒曲Q巧VASSET土廉曲母如iPEJkffiTAH謝試握）昭昨口分fii細逝二迥JKfeilEi聲，乜嚇違號蘋夕幻P4電:C時匕11嚴字/SuiBry/0十弓I用26即26303140414243pTitllgUeti：ir?i：inmid().-|/ary/創(chuàng)銓揚件對毎盍更OMT曲t點事舛,究現(xiàn)/-psrannsie=/parai插件對3?創(chuàng)謹0t引用pubLb:craiTldevoidOrreatit(objecthook)|._|/里擊方法目占土

12、口十弓I用査Et點擊募件口ubLicgyrriduvoLdOnCLickCl06圖2-13:代碼實現(xiàn)通過重載OnCreate和OnClick，實現(xiàn)命令對象的創(chuàng)建，和事件里具體內(nèi)容的實現(xiàn)。注意：Tool（工具插件）：適用于與地圖或制圖組件有交互的插件，只需繼承自BaseTool（繼承自BaseCommand），根據(jù)功能需要可重寫OnMouseDown、OnMouseMove等方法，如：拉框放大、探針、畫多邊形等。Command（命令插件）：與地圖無交互，只需繼承自BaseCommand，重寫OnClick方法，如：全圖、居中放大、前一視圖等。彈出窗體的Command繼承至DesktopComma

13、nd,如空間量測工具，而這里的加載矢量數(shù)據(jù)Command繼承至BaseCommandol13131415161710192021222324252G272029303140414243伽-usingMuTrjrt;usingWinders.Fjl巧Enaiie5pic：ePIEContHH/sunjiary?/矢蚩數(shù)據(jù)加就/枸諸團蛟/a個引用public：VectoTiZoimand()ja_Jjjje二CoiitrolsTEst.Properties.ResourcesDat九LQHdr:r_V亡匚tmithis.U爐竝曲=“加載矢:S數(shù)拯Ithis,嗆砂=5恥0曲如耐曲；thim,TooJ

14、fijj-加tlj矢量數(shù)擁Sham);thiE.Checked=fals亡；this.Enabled-false:/CsuiiTiars/創(chuàng)鑫插件對象/邙mujiriHry/Q個引用publicoverridevoid0r?reatcthook).|/單擊方法/t/EUJinary圖2-14:初始化在構(gòu)造函數(shù)里初始化界面按鈕的樣式：m_Image為按鈕背景圖片；注意：主程序首先通過配置文件查找圖片，若配置文件中的圖片不存在則使用工程中定義的圖片。Caption為按鈕名稱；Name為命令對象的名稱；ToolTip為按鈕提示內(nèi)容；Checked表示初始化時按鈕是否為選中狀態(tài)；Enabled設(shè)置初始

15、化時按鈕的可用性畑rl制=*PIErControlsTc-stVtorC-:申publicorerridcvoidOnCreate(objecthook)七PJEiConlroJsTest,VcctorComm-sndOnOealrlcibjed:hook)publicclassYcctorCoiiJiarid:12131415161726272B2930/構(gòu)造困數(shù)/o亍引由publicVectorConnand(.),|/7/7/CsuiTinaTy)創(chuàng)建插件對象31：j343536I1363940414243Flo個引由publicorErrldevoidOnCrcateIQbjretif

16、(hook=nuLl.)rrturn,if(!.(hookisPIE.Carta.return;this.Enabled=triie,ja_2?oaJrhookja_2?ooLirrJjTiTJLffaoA=hook_|44656667/樂擊方法/C/sLLTJtary0個引用public0rerridcvoid0nClickD.Jaa|圖2-15:創(chuàng)建插件對象通過OnCreate方法傳遞hook對象，也就是MapControl對象，賦值給Command對象的m_Hook和m_HookHelperL:i；lII口ublicoverridevoidOrClickOIf(!thlsEnabled)

17、return.:-rienFlleDialog=nev卽刮“簾脩門，openFileDiale-e-尸詒選擇藝打幵的數(shù)據(jù):：；openFileDialg.=0ShapeFiles|=*.shp;=.OOOx;openFl1eDia.1og.JfL?JT_fetrr=tTUE；i(penFi1eDi11og-&2dgi：JI=Sjjt.商i品配靈豆j-0a餐亡wZt.1肋return;PIE.i/arfd-JJci-jffJjffFactiveVeiv=JuAifirJjper;AetznrKz&r;PIE.i/arfd-JjJfajjnLap=PIE,Carfii.7srlayer=null.

18、:stilngflies=upenPlleDlalogrforLint1二0;1tOrcm：T4llS-,：nKpilOLclwniaeaclti=iniiJtcai=,n遜口忙二用戶孚附Lf3fe=Tfc5nCatwry_0SsflfcrnHl，,1純口肛/耳|=叩farine-TeE=i,/Ginups-CGrcupTalii-BiHcaptinL-Bjjf；BCIs：entbIlc-Type-tuttoahfei匸iLbrar；Efipii匸按壬:.uze5-Ha.a3Ca-xgaryteginSrcnp-pETaEHL11TLf/口eivbL:lLTttjl間ttmri3ecmi：.yFrB”ContrmdTtst.cctaTt：ocrHn(r1工邛口-珂1!5.：曲咖87口1,111.ccprwrr.IUHitffiK瑾”：陽北閑也加丁_比飼【”|01trsn旳応町嚴心匸a?anecer=,n呼mTrinK*v圖2-18:修改配置文件在配置文件中新