PIENET-SDK插件式二次开发文档

1、PIE.NET-SDK插件式二次开发文档一PIE.Net开发环境部署开发环境部署确保Win7系统已安装SP1安装VisualStudio2013(支持VS2010/2012/2013/2015)安装PIESDK.exe二次开发包的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开发包Config配置文件Data坐标系投影及数据映射表Document帮助文件Language语言国际化Res按钮图标及鼠标Cursor样式Sample实例文件Style符号库文件Template$0图模板检验PIEApplication.exe是否可用！二PIE.Net-SDK插件式开发步骤1.新建工程1.1新建项目WitinJtWW旦加同iFd彎呷辛*牌禅鼻*.即1砂图2-1:新建项目图2-2:新建项目注意项目框架选择.NETFramework4,按上图红色框选择新建项目。项目属性配置，保持与SDK开发包一致程序应用平台配置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；应用程序目标框架及生成路径配置鶴ConrralslME-h/icrasoftVkubI曾11曲口皀理员1女血E.fl4Sl

4、規因MQT5YAMKTX顷目冋注戍(踰如1匡队则IMlPM穷SSMfW口溺IMEBJaiHjiBuif*Debjg*jcfei*x.S：Njtee甘的阴罡为恂换I勺sts耀史方甜辟到ei3$.：n；i在恼;罔上至示口:aoto昌NuGetMJ(N)-.设为启加目冏SOT)SI收旳牟呂网在交杵当眺煙髭匸打开立件旳应PSfflR)ExportPrxijfflflIo.psnFilo.图2-6:项目属性图2-7:配置目标框架如方盜吏簡理lfi(dfiM呱尧释Conlrds.r.r|1医CthWllTtilWff电I：3LL&r：Siffl5.l：优此ft&ZiontrckTc朮MkrusettVis

5、ualtiudiaiiR文忡;F)制|问Ifl艮M讨1HhH1如图2-6、2-7所示，右键打开项目属性，在【应用程序】选项卡中确定目标框架.NetFramework4,输出类型为类库。闻CMfokTest-KfiosoftVisualSiudciiBISflj幅旧lifflOQ口门VASEEHSffiSCEJ生盂SWfiJ闵限LMJ工加怕直棗HtQ舸fLM应口期翟聞凹OQ洽匕1屮少：且韵”CpMugi通6，声J*口方1*无INIMIGr-书丘妥面:r廉出沖ttJK迪Ipp皿鼻顽艘因-I$買WLxtocttQg：邙pCkbugYEinPIErCwkolsTMLxiHlB为cm販伽加生Ifi詢+t

6、程賂03S，二3.功能实现3.1添加项目引用ControkTesl-Mieras.ftVisual文忡刃彌旧tKElVJQT5VA1TX顼目世|主成SliM)UfeT)WSS)休玮1510知币N)国口DebugSf.夫方据芟艇苣R?x40、0m丙户二I琴垢諾6缈5兰倉話i：匚七I-;)P”G坯方器8打口1、8计，口伞咱目)”匡芯rrtrokTisM冏B引用调)”.渣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:添加引用浏览添加上图红色框选中的类库，单击确定即可。注意：引用项可以根据自己开发的插件功能需求进行选择3.2以加载矢量数据为例新建Command命令Confcrd-

8、fcTtMiIMkfOfOfl诂luaJ沁idi您毛刘玄聞邛fl|E|flSiQT5VASSZ5TXES|P|土囲Ej财DSUCDUSfO嗣5|区昨齐(d曲肋帥囲匚的*Et:HTDebug0X|型-.Eira砖划罚BlI勻血蔚生碗右左吐BS釜口陶阙宜在忙SB上置说口舷列I=MifGtrlWtiiFih0直力取血月闻相ISS4f：?ara($?Xsinmciri+xXWfeM匕assfiMjC*丘t穴氐SB彌ufT开交甘夬OQ*3|R)观颊SRShfttAH-bA罔Dj引用叫，田务弓用絡，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*顶站兌辰jsiC#项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:实现&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/创銓扬件对毎盍更OMT曲t点事舛,究现/-psrannsie=/parai插件对3?创谨0t引用pubLb:craiTldevoidOrreatit(objecthook)|._|/里击方法目占土

12、口十弓I用査Et点击募件口ubLicgyrriduvoLdOnCLickCl06图2-13:代码实现通过重载OnCreate和OnClick，实现命令对象的创建，和事件里具体内容的实现。注意：Tool（工具插件）：适用于与地图或制图组件有交互的插件，只需继承自BaseTool（继承自BaseCommand），根据功能需要可重写OnMouseDown、OnMouseMove等方法，如：拉框放大、探针、画多边形等。Command（命令插件）：与地图无交互，只需继承自BaseCommand，重写OnClick方法，如：全图、居中放大、前一视图等。弹出窗体的Command继承至DesktopComma

13、nd,如空间量测工具，而这里的加载矢量数据Command继承至BaseCommandol13131415161710192021222324252G272029303140414243伽-usingMuTrjrt;usingWinders.Fjl巧Enaiie5pic：ePIEContHH/sunjiary?/矢蚩数据加就/枸诸團蛟/a个引用public：VectoTiZoimand()ja_Jjjje二CoiitrolsTEst.Properties.ResourcesDat九LQHdr:r_V亡匚tmithis.U炉竝曲=“加载矢:S數拯Ithis,呛砂=5恥0曲如耐曲；thim,TooJ

14、fijj-加tlj矢量数拥Sham);thiE.Checked=fals亡；this.Enabled-false:/CsuiiTiars/创鑫插件对象/邙mujiriHry/Q个引用publicoverridevoid0r?reatcthook).|/单击方法/t/EUJinary图2-14:初始化在构造函数里初始化界面按钮的样式：m_Image为按钮背景图片；注意：主程序首先通过配置文件查找图片，若配置文件中的图片不存在则使用工程中定义的图片。Caption为按钮名称；Name为命令对象的名称；ToolTip为按钮提示内容；Checked表示初始化时按钮是否为选中状态；Enabled设置初始

15、化时按钮的可用性畑rl制=*PIErControlsTc-stVtorC-:申publicorerridcvoidOnCreate(objecthook)七PJEiConlroJsTest,VcctorComm-sndOnOealrlcibjed:hook)publicclassYcctorCoiiJiarid:12131415161726272B2930/构造困数/o亍引由publicVectorConnand(.),|/7/7/CsuiTinaTy)创建插件对象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:创建插件对象通过OnCreate方法传递hook对象，也就是MapControl对象，赋值给Command对象的m_Hook和m_HookHelperL:i；lII口ublicoverridevoidOrClickOIf(!thlsEnabled)

17、return.:-rienFlleDialog=nev卽刮“帘脩门，openFileDiale-e-尸诒选择藝打幵的数据:：；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:修改配置文件在配置文件中新