《ArcGIS Engine+C#实例开发教程》第六讲 右键菜单添加与实现

原文:《ArcGIS Engine+C#实例开发教程》第六讲 右键菜单添加与实现

摘要：在这一讲中，大家将实现TOCControl控件和主地图控件的右键菜单。在AE开发中，右键菜单有两种实现方式，一是使用VS2005自带的ContextMenuStrip控件，二是用AE封装的IToolbarMenu接口。相比较而言，后者更为简单实用，本文采用后者的实现方法。

教程目录：

第一讲 桌面GIS应用程序框架的建立

第二讲 菜单的添加及其实现

第三讲 MapControl与PageLayoutControl同步

第四讲 状态栏信息的添加与实现

第五讲 鹰眼的实现

第六讲 右键菜单添加与实现

教程Bug及优化方案1

第七讲 图层符号选择器的实现1

第七讲 图层符号选择器的实现2

第八讲 属性数据表的查询显示

------------------------------------------------------------------

在上一讲中，我们完成了鹰眼功能，在这一讲中，大家将实现TOCControl控件和主地图控件的右键菜单。

在AE开发中，右键菜单有两种实现方式，一是使用VS2005自带的ContextMenuStrip控件，二是用AE封装的IToolbarMenu接口。相比较而言，后者更为简单实用，本文采用后者的实现方法。

       1、创建右键菜单

在Form1类里面添加如下变量的定义：

        //TOCControl控件变量

private ITOCControl2 m_tocControl = null;

//TOCControl中Map菜单

private IToolbarMenu m_menuMap = null;

//TOCControl中图层菜单

private IToolbarMenu m_menuLayer = null;

在Form1_Load函数进行初始化，即菜单的创建：

m_menuMap = new ToolbarMenuClass();

m_menuLayer = new ToolbarMenuClass();

 

2、添加菜单项

 

第1步中创建的菜单可认为是菜单容器，里面什么都没有，具体的命令或工具作为菜单项添加到菜单容器才能工作。一般情况下，启动程序就要完成菜单项的添加，故此工作在Form1_Load函数完成。

当然，添加菜单项之前，必须实现相应命令或工具。这里的命令或工具可以AE内置的也可以是自定义的。AE内置了许多可以直接调用的常用命令和工具，如ControlsAddDataCommandClass，在ESRI.ArcGIS.Controls命名空间中，大家可以对象浏览器中查看。当然，这里也可以直接调用AE内置的菜单，如ControlsFeatureSelectionMenu。另外，本讲也实现三自定义命令，以做示范。它们分别为图层可视控制命令（用于控制图层显示与否）、移除图层和放大到整个图层命令。实现方法也很简单，就是右击3sdnMap项目，选择“添加|类”，选择C#普通的类模板，用以下代码覆盖系统自己生成的所有代码。

图层可视控制类LayerVisibility代码：

 using ESRI.ArcGIS.ADF.BaseClasses;

using ESRI.ArcGIS.Controls;

using ESRI.ArcGIS.Carto;

using ESRI.ArcGIS.SystemUI;

namespace _sdnMap

{

/// <summary>

/// 图层可视控制

/// </summary>

public sealed class LayerVisibility : BaseCommand, ICommandSubType

{

private IHookHelper m_hookHelper = new HookHelperClass();

private long m_subType;

public LayerVisibility()

{

}

public override void OnClick()

{

for (int i=0; i <= m_hookHelper.FocusMap.LayerCount - 1; i++)

{

if (m_subType == 1) m_hookHelper.FocusMap.get_Layer(i).Visible = true;

if (m_subType == 2) m_hookHelper.FocusMap.get_Layer(i).Visible = false;

}

m_hookHelper.ActiveView.PartialRefresh(esriViewDrawPhase.esriViewGeography,null,null);

}

public override void OnCreate(object hook)

{

m_hookHelper.Hook = hook;

}

public int GetCount()

{

return 2;

}

public void SetSubType(int SubType)

{

m_subType = SubType;

}

public override string Caption

{

get

{

if (m_subType == 1) return "Turn All Layers On";

else  return "Turn All Layers Off";

}

}

public override bool Enabled

{

get

{

bool enabled = false; int i;

if (m_subType == 1)

{

for (i=0;i<=m_hookHelper.FocusMap.LayerCount - 1;i++)

{

if (m_hookHelper.ActiveView.FocusMap.get_Layer(i).Visible == false)

{

enabled = true;

break;

}

}

}

else

{

for (i=0;i<=m_hookHelper.FocusMap.LayerCount - 1;i++)

{

if (m_hookHelper.ActiveView.FocusMap.get_Layer(i).Visible == true)

{

enabled = true;

break;

}

}

}

return enabled;

}

}

}

}

移除图层类RemoveLayer代码：

       using ESRI.ArcGIS.ADF.BaseClasses;

using ESRI.ArcGIS.Carto;

using ESRI.ArcGIS.Controls;

namespace _sdnMap

{

/// <summary>

/// 删除图层

/// </summary>

public sealed class RemoveLayer : BaseCommand

{

private IMapControl3 m_mapControl;

public RemoveLayer()

{

base.m_caption = "Remove Layer";

}

public override void OnClick()

{

ILayer layer = (ILayer)m_mapControl.CustomProperty;

m_mapControl.Map.DeleteLayer(layer);

}

public override void OnCreate(object hook)

{

m_mapControl = (IMapControl3)hook;

}

}

}

放大至整个图层类ZoomToLayer：

       using ESRI.ArcGIS.ADF.BaseClasses;

using ESRI.ArcGIS.Carto;

using ESRI.ArcGIS.Controls;

namespace _sdnMap

{

/// <summary>

/// 放大至整个图层

/// </summary>

public sealed class ZoomToLayer : BaseCommand

{

private IMapControl3 m_mapControl;

public ZoomToLayer()

{

base.m_caption = "Zoom To Layer";

}

public override void OnClick()

{

ILayer layer = (ILayer)m_mapControl.CustomProperty;

m_mapControl.Extent = layer.AreaOfInterest;

}

public override void OnCreate(object hook)

{

m_mapControl = (IMapControl3)hook;

}

}

}

以上三个工具或命令的实现代码比较简单，在此不过多的分析，请读者自行理解。

下面在Form1_Load函数中进行菜单项的添加，代码如下：

       //添加自定义菜单项到TOCCOntrol的Map菜单中

//打开文档菜单

m_menuMap.AddItem(new OpenNewMapDocument(m_controlsSynchronizer), -1, 0, false, esriCommandStyles.esriCommandStyleIconAndText);

//添加数据菜单

m_menuMap.AddItem(new ControlsAddDataCommandClass(), -1, 1, false, esriCommandStyles.esriCommandStyleIconAndText);

//打开全部图层菜单

m_menuMap.AddItem(new LayerVisibility(), 1, 2, false, esriCommandStyles.esriCommandStyleTextOnly);

//关闭全部图层菜单

m_menuMap.AddItem(new LayerVisibility(), 2, 3, false, esriCommandStyles.esriCommandStyleTextOnly);

//以二级菜单的形式添加内置的“选择”菜单

m_menuMap.AddSubMenu("esriControls.ControlsFeatureSelectionMenu", 4, true);

//以二级菜单的形式添加内置的“地图浏览”菜单

m_menuMap.AddSubMenu("esriControls.ControlsMapViewMenu",5, true);

//添加自定义菜单项到TOCCOntrol的图层菜单中

m_menuLayer = new ToolbarMenuClass();

//添加“移除图层”菜单项

m_menuLayer.AddItem(new RemoveLayer(), -1, 0, false, esriCommandStyles.esriCommandStyleTextOnly);

//添加“放大到整个图层”菜单项

m_menuLayer.AddItem(new ZoomToLayer(), -1, 1, true, esriCommandStyles.esriCommandStyleTextOnly);

//设置菜单的Hook

m_menuLayer.SetHook(m_mapControl);

m_menuMap.SetHook(m_mapControl);

3、

弹出右键菜单

顾名思义，右键菜单是在鼠标右键按下的时候弹出，所以我们要添加TOCControl1控件的OnMouseDown事件，实现代码如下：

       private void axTOCControl1_OnMouseDown(object sender, ITOCControlEvents_OnMouseDownEvent e)

{

//如果不是右键按下直接返回

if (e.button != 2) return;

esriTOCControlItem item = esriTOCControlItem.esriTOCControlItemNone;

IBasicMap map = null;

ILayer layer = null;

object other = null;

object index = null;

//判断所选菜单的类型

m_tocControl.HitTest(e.x, e.y, ref item, ref map, ref layer, ref other, ref index);

//确定选定的菜单类型，Map或是图层菜单

if (item == esriTOCControlItem.esriTOCControlItemMap)

m_tocControl.SelectItem(map, null);

else

m_tocControl.SelectItem(layer, null);

//设置CustomProperty为layer (用于自定义的Layer命令)

m_mapControl.CustomProperty = layer;

//弹出右键菜单

if (item == esriTOCControlItem.esriTOCControlItemMap)

m_menuMap.PopupMenu(e.x, e.y, m_tocControl.hWnd);

if (item == esriTOCControlItem.esriTOCControlItemLayer)

m_menuLayer.PopupMenu(e.x, e.y, m_tocControl.hWnd);

}

同样的方法，我们也可以实现主地图控件的右键菜单，以方便地图浏览。添加MapControl1控件的OnMouseDown事件，实现代码如下：

       /// <summary>

/// 主地图控件的右键响应函数

/// </summary>

/// <param name="sender"></param>

/// <param name="e"></param>

private void axMapControl1_OnMouseDown(object sender, IMapControlEvents2_OnMouseDownEvent e)

{

if (e.button == 2)

{

//弹出右键菜单

m_menuMap.PopupMenu(e.x,e.y,m_mapControl.hWnd);

}

}

4、编译运行

按F5编译运行程序，你会发现，原来右键菜单实现起来是这么的简单啊！