【转贴】ArcEngine开发之Command控件使用篇

ArcEngine开发之Command控件使用篇

在ArcEngine类库中有大量的Command控件用来与地图控件进行操作和交互。比如有一系列的地图浏览控件、地图查询控件、图斑选取控件、编辑控件来与MapControl和PageLayoutControl进行交互。这些控件被包含在ESRI.ArcGIS.Controls.dll类库中，位于ESRI.ArcGIS.Controls命名空间下。

这些内置的Command控件可以单独实例化来使用，也可以被安置在一个AxToolbarControl工具栏控件中，继而被存放在一个CommandPool池中以备调用。下面对这两种方式分别加以说明：

第一种使用方式是实例化一个Command对象并显式地运行它：
 

ICommand command  =   new  ControlsOpenDocCommandClass();
command.OnCreate(m_mapControl.Object);
command.OnClick();

其中ControlsOpenDocCommandClass就是一个Command控件，通过调用它的OnCreate方法传递给它需要交互的MapControl，然后调用它的OnClick方法就可以运行。上面的例子会激活一个打开地图文档的对话框。

另一种方法是更加常用的方法。

由于每个Command对象都是一个COM组件，所以ESRI.ArcGIS.Controls下的各个类只是对底层的COM对象的一种封装。由于是COM对象，所以每一个Command对象都有自己的CLSID和ProgID，并在安装Engine Runtime的时候被注册了，你可以在注册表的HKEY_LOCAL_MACHINE/SOFTWARE/Classes/CLSID/找到这些Command的注册信息，如果要查找所有Command的信息，请访问 Built-in commands。由于是COM组件，在实例化它的过程中，.net需要实例化一个Runtime Callable Wrapper（RCW）对象，来代理对COM组件的调用。

由于大部分对地图控件的操作都直接或间接的来自于工具栏，比如点击工具栏上面的放大、缩小、全图按钮。那么实际上我们的绝大部分Command对象都可以被寄放到这个工具栏之中。方法非常简单：

axToolbarControl1.AddItem( " esriControls.ControlsMapZoomInTool " );

此处使用的esriControls.ControlsMapZoomInTool就是ControlsMapZoomInToolClass类所指向的COM组件的ProgID，需要所有这些Command的信息时，你应该到Built-in commands这个页面下查找，或在你的Engine帮助文档中ms-help://ESRI.EDNv9.2/NET_Engine/b9a335a2-f653-44a1-8961-89051f2e958f.htm的位置。

通过AddItem添加到工具栏中的Command控件使用非常方便，添加了它以后你就再不用操心进一步的处理它与地图控件的交互了。Engine内部是怎么做到这一点的呢，记得我们在第一种方法中实例化一个Command控件时调用的OnCreate方法吗，当时我们传递给它一个MapControl来告诉它需要控制哪一个地图控件。而通过axToolbarControl1.AddItem添加的控件，由于ToolbarControl将这个控件放到自己的控件池时，就已经调用了它的OnCreate方法，并传递给了它自己的BuddyControl作为控制对象，于是，一切都变得简单了。

在实际开发项目中，我们往往不想暴露出ArcEngine内置的ToolBar控件，而是给用户展示我们自己开发的工具栏控件。另一方面，我们也想使用这种简单的添加控件机制。如果做到呢，方法就是在设计阶段，仍然拖放一个ToolbarControl到窗体上，但是在属性中将它的Visible设置为false，这样就不会显示出来了，而我们可以往这个工具栏中添加大量的Command控件。

这个隐藏的工具栏如何使用呢，请看下面这个函数：

public   void  SetCurrentMapTool( string  commandName)
{
   // 先重置地图当前工具
  m_Map.CurrentTool  =   null ;
   for  ( int  i  =   0 ; i  <  m_toolbarControl.CommandPool.Count; i ++ )
  {
    _command  =  m_toolbarControl.CommandPool.get_Command(i);

     if  (_command.Name  ==  commandName)
    {
      m_Map.CurrentTool  =  _command  as  ITool;
      _command.OnClick();
       break ;
    }
  }
}

前面提到ToolbarControl内部维护一个Command池，在这个池中存放了所有已添加的Command对象，获取其中的Command可以通过CommandPool的get_Command方法，通过比较Command的名称，可以得到想要的Command对象。这个名称可不同于ProgID，它是另一个用来标识Command控件的字符串，具体的请在Built-in commands上查找（第一列），比如我们之前添加的ZoomInTool控件，它的ProgID是esriControls.ControlsMapZoomInTool，它的Name是ControlToolsMapNavigation_ZoomIn。
请注意这一行：

m_Map.CurrentTool  =  _command  as  ITool;

当Command对象处理的不只是打开地图，显示全图这类没有与地图交互的功能时，简单的使用OnClick即可，但是当需要的是拖动鼠标控制缩放，空间查询这类必须与地图进行交互的动作时，就必须设置MapControl的CurrentTool属性。

通过上面介绍的方法，就可以不仅利用Toolbar控件管理Command功能，又可以提供丰富的UI，保证表现层的灵活性。

内置的一系列Command控件可以满足我们很多的功能需求，但是仍有稍显不足的时候，比如Identify控件的全英文界面，会使有些用户抓狂。这时，我们可以通过自己开发Command控件来扩展出我们需要的功能，并可以像内置Command一样的使用。以后的文章会给大家来介绍。