Add-in学习讲述.docx

1.Building custom UI elements using add-ins （source：Developer help） 1.1了解XML文件 ·xml文件根据向导输入内容由系统自动生成，文件名通常为Config.esruaddinx。 ·XML文件包括元文件信息（Add-in Meta-data Information）、安装目标、Addin等多项内容。 |-元文件信息：包括Name、AddInID、Version、Image、Author、Company等元素。其中AddInID是描述该插件的全局唯一ID（Globally Unique Identifier，GUID）。 |-Target元素：描述插件的运行目标、版本等信息 |-AddIn元素：Addin元素内包含了用户的自定义元素：Button、Tool等。Addin属性描述了编程的环境:Language、library等。 1.2向Button对象类插入ZoomToLayer功能 · Button类继承于ESRI.ArcGIS.Desktop.AddIns.Button抽象类；内部包含OnClick、Onupdate两种重要的方法，并且这两个方法必须被重写（Protected override）。 |-OnClick:在ArcMap中的Click事件触发 |-OnUpdate：周期性地触发该事件，以完成某些动作。详细见帮助文档： HYPERLINK :47873/help/1-5124/ms.help?method=pageid=2B7E0BA7-C8E1-47E5-916A-47763BAF4768product=VSproductVersion=100topicVersion=locale=EN-UStopicLocale=EN-US Add-in coding patterns 要完成Zoomtolayer功能，可使用ArcGIS Snippet Finder tool，搜索ZoomToLayer，得到“Zoom to Active Layer in TOC snippet”，Insert。  随后，在Onclick方法中插入代码： ZoomToActiveLayerInTOC(ArcMap.Application.Document as IMxDocument); ArcMap对象类由插件创建向导自动生成，代码在config.designer.cs文件中。关于自动生成类可以在VS的对象浏览器（Object Browser）中查看。ArcMap中有Application、Dockablewindowmanager、Document等三个常用的属性需要注意。 1.3 用户自定义Tool实现Adding AddGraphics功能 ·Tool提供OnMouseDown（）和OnMouseUp（）事件捕获用户操作，同样需要重写这两种方法。 protected override void OnMouseDown(ESRI.ArcGIS.Desktop.AddIns.Tool.MouseEventArgs arg) { //Get the active view from the ArcMap static class. IActiveView activeView = ArcMap.Document.ActiveView; //If its a polyline object, get from the users mouse clicks. IPolyline polyline = GetPolylineFromMouseClicks(activeView); //Make a color to draw the polyline. IRgbColor rgbColor = new RgbColorClass(); rgbColor.Red = 255; //Add the users drawn graphics as persistent on the map. AddGraphicToMap(activeView.FocusMap, polyline, rgbColor, rgbColor); //Best practice: Redraw only the portion of the active view that contains graphics. activeView.PartialRefresh(esriViewDrawPhase.esriViewGraphics, null, null