PIE SDK地图放大镜

放大镜，在地图的浏览过程中在主地图和次地图中起到很好的辅助作用，

要实现放大镜功能主要就是通过两个mapControl控件，主地图控件是mapControlMain，放大镜控件是UserControl_Magnifier，实现关键点有两点：1、如何使两个控件使用的数据保持一致；2、如何绘制放大镜中的元素框。

一、数据一致

当主地图添加地图图层数据就会触发接口IActiveViewEvents接口中的地图添加事件OnLayerAdded，或者图层的删除等操作，放大镜的控件就会将图层数据添加到放大镜视图中。 mapControl1代表的是放大镜中的地图控件

  /// <summary>
 /// 加载事件
 /// </summary>
 /// <param name="sender"></param>
 /// <param name="e"></param>
 private void UserControl_MagnifyingGlass_Load(object sender, EventArgs e)
 {
     if (!m_BInitialized) return;
     load();
     addElement();
     IActiveViewEvents activeViewEvents = (IActiveViewEvents)m_ActiveView;
     activeViewEvents.OnLayerAdded += activeViewEvents_OnLayerAdded;
     activeViewEvents.OnLayerDeleted += activeViewEvents_OnLayerDeleted;
   }

 /// <summary>
 /// OnLayerAdded事件
 /// </summary>
 /// <param name="layer"></param>
 void activeViewEvents_OnLayerAdded(ILayer layer)
 {
     load();
     addElement();
 }
 /// <summary>
 /// 加载函数
 /// </summary>
 private void load() {
 if (!m_BInitialized) return;
     mapControl1.FocusMap = m_ActiveView.FocusMap.Clone();
     mapControl1.Extent = m_ActiveView.Extent;
     mapControl1.ActiveView.DisplayTransformation.MapScale =;    mapControl1.PartialRefresh(ViewDrawPhaseType.ViewAll);
 }

二、绘制放大镜的显示框

显示框采用的是曲线元素和线元素（ILineElemnet和ICurveElement）。

放大镜的功能主要包括两种操作，第一：当鼠标在主地图上移动的时候，放大镜的范围以鼠标移动的地方为中心按照一定的比例进行显示，圆和十字元素的中心就是放大镜地图的中心，本示例中比例固定设置为3，放大镜地图中的范围显示框跟着变化；第二，主地图的视图范围发生变化时，放大镜地图的显示范围和显示框也会跟着变化。

1、当鼠标在主地图上移动的时候，会触发MouseMove事件，那么放大镜的地图范围就会以鼠标所移动的坐标为中心进行范围显示。

 /// <summary>
 /// MouseMove事件
 /// </summary>
 /// <param name="sender"></param>
 /// <param name="e"></param>
 private void mapControl_MouseMove(object sender, MouseEventArgs e)
 {
 IMapControl mapControl = m_Application.MapControl;
 IMapControl mapControl1 = m_Magnifier.GetMapControl();
 PIE.Geometry.IPoint point = mapControl.ToMapPoint(e.X, e.Y);
 m_Point = point;
 mapControl1.CenterAt(point);
 m_Magnifier.addElement();
 }

 /// <summary>
 /// 添加准星函数（绘制放大镜地图中的显示框一个圆和一个十字形）
 /// </summary>
 public void addElement() {
     IEnvelope extent = mapControl1.Extent;
     IGraphicsContainer graphicsContainer = mapControl1.ActiveView.GraphicsContainer;
     graphicsContainer.DeleteAllElements();

     IPointCollection line1 = new Polyline();
     line1.AddPoint((extent.XMin + extent.XMax) / , extent.YMin);
     line1.AddPoint((extent.XMin + extent.XMax) / , extent.YMax);

     ILineSymbol symbol = new SimpleLineSymbol();
     symbol.Color = Color.Red;

     ILineElement lineElement1 = new LineElement();
     lineElement1.Geometry = line1 as IGeometry;
     lineElement1.Symbol = symbol;

     IPointCollection line2 = new Polyline();
     line2.AddPoint(extent.XMin, (extent.YMin + extent.YMax) / );
     line2.AddPoint(extent.XMax, (extent.YMin + extent.YMax) / );
     ILineElement lineElement2 = new LineElement();
     lineElement2.Geometry = line2 as IGeometry;
     lineElement2.Symbol = symbol;

     IArc arc = new Arc();
     arc.PutCoords((extent.XMin + extent.XMax) / , (extent.YMin + extent.YMax) / );
     arc.StartAngle = ;
     arc.EndAngle = ;
     arc.SemiMajor = (extent.XMax - extent.XMin) / ;
     arc.SemiMinor = (extent.XMax - extent.XMin) / ;

     ICurveElement curveElement = new CurveElement();
     curveElement.Geometry = arc as IGeometry;
     curveElement.Symbol = symbol;

     graphicsContainer.AddElement(lineElement1);
     graphicsContainer.AddElement(lineElement2);
     graphicsContainer.AddElement(curveElement);

     mapControl1.PartialRefresh(ViewDrawPhaseType.ViewAll);
 }
     /// <summary>
     /// OnVisibleBoundsUpdated事件
     /// </summary>
     /// <param name="displayTransformation"></param>
     /// <param name="bVisibleBoundChanged"></param>
     private void TransformEvent_OnVisibleBoundsUpdated(IDisplayTransformation displayTransformation, bool bVisibleBoundChanged)
     {
     IMapControl mapControl1 = m_Magnifier.GetMapControl();

     PIE.Carto.IActiveView activeView = m_HookHelper.ActiveView;
     PIE.Geometry.IPoint point = (activeView.Extent as PIE.Geometry.IGeometry).Centroid();
     mapControl1.ActiveView.PanTo(point);
     mapControl1.ActiveView.DisplayTransformation.MapScale = ;

     mapControl1.CenterAt(m_Point);
     m_Magnifier.addElement();
     mapControl1.PartialRefresh(ViewDrawPhaseType.ViewAll);
     }

2、当主地图mapControlMain范围发生变化时，会触发OnVisibleBoundsUpdated事件，那么放大镜的显示框的位置和范围应跟着发生变化。

 ITransformEvents transformEvent = (ITransformEvents)activeView.DisplayTransformation; transformEvent.OnVisibleBoundsUpdated += TransformEvent_OnVisibleBoundsUpdated;
 /// <summary>
     /// OnVisibleBoundsUpdated事件
     /// </summary>
     /// <param name="displayTransformation"></param>
     /// <param name="bVisibleBoundChanged"></param>
     private void TransformEvent_OnVisibleBoundsUpdated(IDisplayTransformation displayTransformation, bool bVisibleBoundChanged)
     {
     IMapControl mapControl1 = m_Magnifier.GetMapControl();

     PIE.Carto.IActiveView activeView = m_HookHelper.ActiveView;
     PIE.Geometry.IPoint point = (activeView.Extent as PIE.Geometry.IGeometry).Centroid();
     mapControl1.ActiveView.PanTo(point);
     mapControl1.ActiveView.DisplayTransformation.MapScale = ;

     mapControl1.CenterAt(m_Point);
     m_Magnifier.addElement();
     mapControl1.PartialRefresh(ViewDrawPhaseType.ViewAll);
 }

  代码路径：

项目名称	百度云盘地址下/PIE示例程序/13.小工具集锦/地图平移校正/ PIEMapApplication1
数据路径	百度云盘地址下/PIE示例数据/栅格数据/04.World/World.tif
视频路径	百度云盘地址下/PIE视频教程/13.小工具集锦/地图放大镜.avi

注意：

在地图初始化的时候，图层树控件需要手动绑定地图控件：

tocControlMain.SetBuddyControl(mapControlMain as PIE.Carto.IPmdContents);