高级功能开发
ArcGIS Engine 二次开发
——提高篇
高级功能开发
1 缩略图(鹰眼)
鹰眼功能是 GIS 的主要功能之一，当地图范围很大时，它可以很好的为用户指明当前
地图的范围。在本小节中我们将学习如何制作这种鹰眼。
1.1 添加控件
新建一个 项目，项目名称为 ，将 的名字设置为 ，并
添加 、两个 和 等四个控件。布局如下图所示。左
边的 ! 用于地图数据显示和操作，右边 !" 用于鹰眼显示。
图 1 界面布局
在 加载添加数据按钮和地图浏览的功能按钮，如下图所示，并将
的伙伴控件设为 !。
图 2 添加按钮
1.2 代码添加及解释
鹰眼用来显示主窗体当前视图范围在全景视图中的位置，在 中使用一个线框
在鹰眼视图中标识。当主视图中的视图范围改变时，鹰眼中的线框随之改变，当拖动鹰眼
视图中的红线框时，主视图中的视图范围也随之改变。
下面开始实现鹰眼功能，添加 #$%、#$%&、
#$%'$& 三个引用。首先在 ! 中视图范围改变时鹰眼窗体要做
出对应的响应，即绘制线框并显示，在 !()) 事件中添加代码如下：
private void axMapControl1_OnExtentUpdated(object sender,
ESRI.ArcGIS.Controls.IMapControlEvents2_OnExtentUpdatedEvent e)
{
//创建鹰眼中线框
IEnvelope pEnv = (IEnvelope)e.newEnvelope;
IRectangleElement pRectangleEle = new RectangleElementClass();
IElement pEle = pRectangleEle as IElement;
pEle.Geometry = pEnv;
//设置线框的边线对象，包括颜色和线宽
IRgbColor pColor = new RgbColorClass();
pColor.Red = 255;
pColor.Green = 0;
pColor.Blue = 0;
pColor.Transparency = 255;
// 产生一个线符号对象
ILineSymbol pOutline = new SimpleLineSymbolClass();
pOutline.Width = 2;
pOutline.Color = pColor;
// 设置颜色属性
pColor.Red = 255;
pColor.Green = 0;
pColor.Blue = 0;
pColor.Transparency = 0;
// 设置线框填充符号的属性
IFillSymbol pFillSymbol = new SimpleFillSymbolClass();
pFillSymbol.Color = pColor;
pFillSymbol.Outline = pOutline;
IFillShapeElement pFillShapeEle = pEle as IFillShapeElement;
pFillShapeEle.Symbol = pFillSymbol;
// 得到鹰眼视图中的图形元素容器
IGraphicsContainer pGra = axMapControl2.Map as IGraphicsContainer;
IActiveView pAv = pGra as IActiveView;
// 在绘制前，清除 axMapControl2 中的任何图形元素
pGra.DeleteAllElements();
// 鹰眼视图中添加线框
pGra.AddElement((IElement)pFillShapeEle, 0);
// 刷新鹰眼
pAv.PartialRefresh(esriViewDrawPhase.esriViewGraphics, null, null);
}
当鼠标点击鹰眼窗体时，主窗体 ! 随之改变。在 !" 的 #$'
事件中添加代码如下：
private void axMapControl2_OnMouseDown(object sender,
ESRI.ArcGIS.Controls.IMapControlEvents2_OnMouseDownEvent e)
{
if (this.axMapControl2.Map.LayerCount != 0)
{
// 按下鼠标左键移动矩形框
if (e.button == 1)
{
IPoint pPoint = new PointClass();
pPoint.PutCoords(e.mapX, e.mapY);
IEnvelope pEnvelope = this.axMapControl1.Extent;
pEnvelope.CenterAt(pPoint);
this.axMapControl1.Extent = pEnvelope;
this.axMapControl1.ActiveView.PartialRefresh(esriViewDrawPhase.esriViewGeography,
null, null);
}
// 按下鼠标右键绘制矩形框
else if (e.button == 2)
{
IEnvelope pEnvelop = this.axMapControl2.TrackRectangle();
this.axMapControl1.Extent = pEnvelop;
this.axMapControl1.ActiveView.PartialRefresh(esriViewDrawPhase.esriViewGeography,
null, null);
}
}
}
当 鼠 标 在 鹰 眼 窗 体 移 动 时 ， 主 窗 体 ! 随 之 改 变 。 在 !" 的
#$ 事件中添加代码如下：
private void axMapControl2_OnMouseMove(object sender,
ESRI.ArcGIS.Controls.IMapControlEvents2_OnMouseMoveEvent e)
{
// 如果不是左键按下就直接返回
if (e.button != 1) return;
IPoint pPoint = new PointClass();
pPoint.PutCoords(e.mapX, e.mapY);
this.axMapControl1.CenterAt(pPoint);
this.axMapControl1.ActiveView.PartialRefresh(esriViewDrawPhase.esriViewGeography, null,
null);
}
下面代码用于实现 !" 与 ! 的数据的同步更新，获取主视图中
视图范围最大的图层作为鹰眼中的视图。这个更新由两部分组成，一个是对 !
添加地图文档（!) 文件）的响应，通过 ! 的 % 事件实现，一个
是对 ! 添加单个图层的响应，通过 ! 的 #!()) 事件
实现。我们获取主视图中的视图范围最大的图层写成一个独立的函数，方便调用。
private ILayer GetOverviewLayer(IMap map)
{
//获取主视图的第一个图层
ILayer pLayer = map.get_Layer(0);
//遍历其他图层，并比较视图范围的宽度，返回宽度最大的图层
ILayer pTempLayer = null;
for (int i = 1; i < map.LayerCount;i++ )
{
pTempLayer = map.get_Layer(i);
if (pLayer.AreaOfInterest.Width < pTempLayer.AreaOfInterest.Width)
pLayer = pTempLayer;
}
return pLayer;
}
然后在 ! 的 %) 事件中调用。
private void axMapControl1_OnMapReplaced(object sender,
IMapControlEvents2_OnMapReplacedEvent e)
{
//获取鹰眼图层
this.axMapControl2.AddLayer(this.GetOverviewLayer(this.axMapControl1.Map));
// 设置 MapControl 显示范围至数据的全局范围
this.axMapControl2.Extent = this.axMapControl1.FullExtent;
// 刷新鹰眼控件地图
this.axMapControl2.Refresh();
}
