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

12 篇文章 1 订阅

在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一样的使用。以后的文章会给大家来介绍。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值