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

1、PIE.NET-SDK插件式二次開(kāi)發(fā)文檔一PIE.Net開(kāi)發(fā)環(huán)境部署開(kāi)發(fā)環(huán)境部署確保Win7系統(tǒng)已安裝SP1安裝VisualStudio2013(支持VS2010/2012/2013/2015)安裝PIESDK.exe二次開(kāi)發(fā)包的A版本2.【SDK】安裝后目錄說(shuō)明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開(kāi)發(fā)包Config配置文件Data坐標(biāo)系投影及數(shù)據(jù)映射表Document幫助文件Language語(yǔ)言國(guó)際化Res按鈕圖標(biāo)及鼠標(biāo)Cursor樣式Sample實(shí)例文件Style符號(hào)庫(kù)文件Template$0圖模板檢驗(yàn)PIEApplication.exe是否可用！二PIE.Net-SDK插件式開(kāi)發(fā)步驟1.新建工程1.1新建項(xiàng)目WitinJtWW旦加同iFd彎呷辛*牌禪鼻*.即1砂圖2-1:新建項(xiàng)目圖2-2:新建項(xiàng)目注意項(xiàng)目框架選擇.NETFramework4,按上圖紅色框選擇新建項(xiàng)目。項(xiàng)目屬性配置，保持與SDK開(kāi)發(fā)包一致程序應(yīng)用平臺(tái)配置Can

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

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

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

6、程賂03S，二3.功能實(shí)現(xiàn)3.1添加項(xiàng)目引用ControkTesl-Mieras.ftVisual文忡刃彌舊tKElVJQT5VA1TX頊目世|主成SliM)UfeT)WSS)休瑋1510知幣N)國(guó)口DebugSf.夫方據(jù)芟艇苣R?x40、0m丙戶二I琴垢諾6緲5蘭倉(cāng)話i：匚七I-;)P”G坯方器8打口1、8計(jì)，口傘咱目)”匡芯rrtrokTisM冏B引用調(diào))”.渣urn超引冃.苗酋淫HuGet輕污豈時(shí).跟立曲比范圍卜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:添加引用展開(kāi)項(xiàng)目目錄樹(shù)，右鍵點(diǎn)擊【引用】選擇【添加引用】菜單項(xiàng)。在彈出的引用管理器中點(diǎn)擊【程序集】的【擴(kuò)展】項(xiàng)下拉選擇。圖2-10:添加引用瀏覽添加上圖紅色框選中的類庫(kù)，單擊確定即可。注意：引用項(xiàng)可以根據(jù)自己開(kāi)發(fā)的插件功能需求進(jìn)行選擇3.2以加載矢量數(shù)據(jù)為例新建Command命令Confcrd-

8、fcTtMiIMkfOfOfl詁luaJ沁idi您毛劉玄聞邛fl|E|flSiQT5VASSZ5TXES|P|土囲Ej財(cái)DSUCDUSfO嗣5|區(qū)昨齊(d曲肋帥囲匚的*Et:HTDebug0X|型-.Eira磚劃罰BlI勻血蔚生碗右左吐BS釜口陶闕宜在忙SB上置說(shuō)口舷列I=MifGtrlWtiiFih0直力取血月聞相ISS4f：?ara($?Xsinmciri+xXWfeM匕assfiMjC*丘t穴氐SB彌ufT開(kāi)交甘夬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項(xiàng)bWtbiindDwsformsDevEwp日鉆91-4.2ORMPiersirtenlObject埔SUHC#項(xiàng)WP1F弼KBDrExprestvl-4.2RepcrtWizard怕皿甘C*頂站兌辰j(luò)siC#項(xiàng)DevExprestDai&pFXE.XAFTB.C#項(xiàng)R亡p口rringSQL5erver冋Windows璧值埔suHC#項(xiàng)VMdrkfbWuMC#項(xiàng)fEl罔到槪M-wJ3項(xiàng)C#項(xiàng)空尹eVSwaiC#曲ADO.wr-軽WuMC#項(xiàng)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:實(shí)現(xiàn)&a強(qiáng)匸ciEinmn堆令CErrdBTaa-MiDraivo-4iViiujI立uu|百豈云）卻4EI期ID理冒曲Q巧VASSET土廉曲母如iPEJkffiTAH謝試握）昭昨口分fii細(xì)逝二迥JKfeilEi聲，乜嚇違號(hào)蘋(píng)夕幻P4電:C時(shí)匕11嚴(yán)字/SuiBry/0十弓I用26即26303140414243pTitllgUeti：ir?i：inmid().-|/ary/創(chuàng)銓揚(yáng)件對(duì)毎盍更OMT曲t點(diǎn)事舛,究現(xiàn)/-psrannsie=/parai插件對(duì)3?創(chuàng)謹(jǐn)0t引用pubLb:craiTldevoidOrreatit(objecthook)|._|/里擊方法目占土

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

13、nd,如空間量測(cè)工具，而這里的加載矢量數(shù)據(jù)Command繼承至BaseCommandol13131415161710192021222324252G272029303140414243伽-usingMuTrjrt;usingWinders.Fjl巧Enaiie5pic：ePIEContHH/sunjiary?/矢蚩數(shù)據(jù)加就/枸諸團(tuán)蛟/a個(gè)引用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)鑫插件對(duì)象/邙mujiriHry/Q個(gè)引用publicoverridevoid0r?reatcthook).|/單擊方法/t/EUJinary圖2-14:初始化在構(gòu)造函數(shù)里初始化界面按鈕的樣式：m_Image為按鈕背景圖片；注意：主程序首先通過(guò)配置文件查找圖片，若配置文件中的圖片不存在則使用工程中定義的圖片。Caption為按鈕名稱；Name為命令對(duì)象的名稱；ToolTip為按鈕提示內(nèi)容；Checked表示初始化時(shí)按鈕是否為選中狀態(tài)；Enabled設(shè)置初始

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

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

17、return.:-rienFlleDialog=nev卽刮“簾脩門(mén)，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瑾”：陽(yáng)北閑也加丁_比飼【”|01trsn旳応町嚴(yán)心匸a?anecer=,n呼mTrinK*v圖2-18:修改配置文件在配置文件中新