建立自定义命令扩展ArcGIS

return; } IActiveView activeView = mxDocument.ActiveView; // Get the TOC IContentsView IContentsView = mxDocument.CurrentContentsView; // Get the selected layer System.Object selectedItem = IContentsView.SelectedItem; if (!(selectedItem is ILayer)) {
似，但二者的不同之处也值得注意：一个类可以实现多个接口，但是只能继承自一个抽象类。 归功于 ArcGIS-Visual Studio 集成框架，当使用添加项目模板为 ArcMap Desktop 创建命令
时，会自动实现大部分托管代码。比如，自动创建了一个 IApplication 接口成员变量、构造 函数、重写 OnCreate 和 OnClick 方法等。当然，要完全实现所需功能，仍需进一步完善这些 自动实现的代码。
在上一步点击确定后，弹出 ArcGIS Project Wizard，可以利用该向导添加 ESRI 对象库引 用。因为现在创建的是 ArcGIS Desktop 应用程序，所以只有与 ArcGIS Desktop 相关的程序集
建立自定义命令扩展ArcGIS
才显示于该向导中。添加 ESRI.ArcGIS.ADF.Local，ESRI.ArcGIS.ArcMapUI，ESRI.ArcGIS.Carto， ESRI.ArcGIS.Framework，ESRI.ArcGIS.Geometry，ESRI.ArcGIS.System 和 ESRI.ArcGIS.SystemUI 这 7 个引用。点击 Finish 以创建项目。如下图所示。
除了添加 ESRI 引用之外，还得添加 System.Drawing 引用。在添加引用对话框的.NET 选 项卡下选中 System.Drawing，单击确定。如下图所示。
建立自定义命令扩展ArcGIS
删除 class1 文件 删除项目默认创建的 class1.cs 文件，因为在该项目中不会使用该文件。
ZoomToLayer的定义语句，表示ZoomToLayer是继承自BaseCommand抽象类的。如下所示。
public sealed class ZoomToLayer : BaseCommand
为构造函数添加代码 完善 ZoomToLayer 的构造函数（覆写 BaseCommand 抽象类的构造函数），以实现客户化
添加缩放至图层的功能
除了覆写抽象类的一些方法之外，还必须添加一些自定义的方法，以实现自定义的功能。 添加 ZoomToActiveLayerInTOC 方法如下。
public void ZoomToActiveLayerInTOC(IMxDocument mxDocument) {
if (mxDocument == null) {
定制所需功能与效果。 在 ZoomToLayer.cs 文件中，找到默认添加的构造函数，可以发现其所有属性都是空字符
串，这些值是该命令嵌入 ArcGIS 时呈现给使用者的信息，在此修改它们为合适的值。如下 代码所示。
建立自定义命令扩展ArcGIS
public ZoomToLayer() {
// // TODO: Define values for the public properties // base.m_category = "Hans_GIS"; //localizable text base.m_caption = "缩放至图层"; //localizable text base.m_message = "缩放至内容目录窗口中活动图层的范围"; //localizable text base.m_toolTip = "缩放至图层"; //localizable text base.m_name = "Hans_GIS_ZoomToLayer"; //unique id, non-localizable (e.g. "MyCategory_ArcMapCommand")
开启 VS2010，以 Visual C# >> ArcGIS >>Extending ArcObjects 下的 Class Library (ArcMap) 为模板创建一个新类库项目，将该项目命名为 CmdZoomToLayer，选择合适的存储位置，单 击确定。如下图所示。
添加引用
为该项目添加所需的 ESRI 对象库引用以及 System.Drawing 引用。 ESRI 提供的 ESRI.ArcGIS.ADF.Local 程序集包含了 ESRI.ArcGIS.ADF.BaseClasses 命名空间， 可以继承该程序集所提供的一些抽象类来创建一个自定义命令/工具。该程序集还包含了 ESRI.ArcGIS.ADF.CATIDs 命名空间，其中的一些类可用于注册组件至合适的 ESRI 组件类别。
建立自定义命令扩展ArcGIS
建立自定义命令扩展 ArcGIS
关于本文
华中师范大学城市与环境科学学院 韩锁
本文演示如何创建一个简单的命令，实现缩放至所选图层范围的功能。该命令继承自 ESRI 公司的 ADF 里的 BaseCommand 类。以下是详细实现步骤。
注：本文演示环境 VS2020 & C# & ArcGIS 10.0 创建一个类库
在 ArcMap 中使用该命令
启动 ArcMap，打开一个地图文档。单击自定义 >> 自定义模式。在打开的自定义对话 框中选择命令面板，在类别栏目下选中 Hans_GIS，即可看到缩放至图层命令显示于命令栏 目下。如图所示。
建立自定义命令扩展ArcGIS
可以看到显示于该界面下的命令的类别与标题是与构造函数中的信息是一致的。如果在 该步骤找不到所定制的类别与命令，那么在 Visual Studio 2010 中打开项目属性，确保选中生 成面板中的为 COM 互操作注册，然后再次编译项目。
try {
// // TODO: change bitmap name if necessary // string bitmapResourceName = GetType().Name + ".png"; base.m_bitmap = new Bitmap(GetType(), bitmapResourceName); } catch (Exception ex) { System.Diagnostics.Trace.WriteLine(ex.Message, "无效的图标"); } }
在弹出的 ArcGIS New Item Wizard Options 对话框中选择 Desktop or ArcMap Command， 单击 OK。如下图所示。
建立自定义命令扩展ArcGIS
更换默认图标 默认的，项目中已经添加了一张位图用作该命令的图标，可以是用图像编辑器对位图进
行编辑。本示例中，删除原位图，再手工添加一张新位图以用作该命令的图标。 删除原位图 ZoomToLayer.bmp 文件。 在解决方案资源管理器中，右键单击项目，选择添加 >> 现有项，在添加现有项对话框
暴露 ZoomToLayer 类为 COM
ArcGIS 是一套基于 COM 的应用程序，我们现如今在.NET 平台下编辑的类必须暴露为 COM 才能为 ArcGIS 正确识别并使用。基于 BaseCommand 模板建立.NET 程序集时，这个工 作已经由模板自动完成了。感兴趣的话请参考#region COM Registration Function(s)代码片段。
添加 GetMxDocumentFromArcMap 方法如下。
public IMxDocument GetMxDocumentFromArcMap(IApplication application) {
if (application == null) {
return null; } IDocument document = application.Document; IMxDocument mxDocument = (IMxDocument)(document); // Explicit Cast return mxDocument; }
在 ArcMap 中单击命令时，会激发其 OnClick 事件，要想实现缩放至图层功能，还得在 OnClick 方法中调用前面添加的两个方法。如下所示。
public overrideห้องสมุดไป่ตู้void OnClick() {
// TODO: Add ZoomToLayer.OnClick implementation IMxDocument mxDocument =GetMxDocumentFromArcMap(m_application); ZoomToActiveLayerInTOC(mxDocument); }
单击缩放至图层命令并拖放至 ArcMap 的任一工具栏，然后关闭自定义对话框。返回到 ArcMap，在内容目录窗口中单击一个图层，然后单击刚添加的缩放至图层命令，地图就被 缩放至该图层的范围。如下所示。
总结 本文详细讲述了如何使用 ArcGIS 集成模板建立一个命令来扩展 ArcGIS 的功能。（完）
中，导航至存储有合适的图标文件的文件夹，选中合适的图标，单击添加，将其复制到项目 目录下。更改其名称前缀为 ZoomToLayer，并在属性窗口中将其生成操作属性更改为嵌入的 资源。如下图所示。
继承 BaseCommand 抽象类 抽象类是不能被实例化的类，抽象类可包含不被实现的抽象方法。抽象类与接口较为类
编译项目
保存对项目所做的所有更改，单击生成 >> 生成解决方案。可以在项目文件夹的子目录 下查看到生成结果。在 Bin\Debug 目录下可以看到有一个动态链接库文件(DLL)、另外两个文 件(PDB & TLB)是由程序集注册工具生成的。