ArcGIS Engine 10 开发手册(3-10)MapControl 控件与PageLayout控件的联动

     视图控件PageLayoutControl

     在 ArcMap 中除了在介绍 MapControl 控件的时候提到的数据视图，还有另外一种视图，就是布局视图 (Layout)，PageLlayoutControl 控件则对应了 ArcMap 中的布局视图。PageLayoutControl 控件主要用于制图， 它可以方便的操作各种元素对象，以产生一副精美的地图对象出来。该控件中封装了一个 PageLayout 对象，这个对象用于控制布局视图中的对象的属性。

 

      MapControl 控件与PageLayout控件的联动

      要实现这两个控件的联动，我们首先回顾下 ArcMap 中的情景，两个控件的联动不仅仅是简单 的切换，在切换的时候还因该保留各自控件上的一些状态，比如说当我们在 MapControl 上有一个放大操作 时，当我们没有将这个放大操作取消而切换到 PageLayout 控件，在 PageLayout 控件上做了一些操作后，又 切换到 MapControl 控件，我们应该还应该能进行放大操作而不用重新使用放大这个工具。

 

      通过分析我们可以得到下面几点：

 

      当切换两个控件的时候，地图的同步

      各自控件上激活的工具或者命令的保留

      当存在 TOC 控件和 ToolBar 控件的时候，切换了地图控件和布局控件，那么这两个控件的伙伴控 件也应发生变化。

      在 Form 中添加 TabControl 控件，分别将地图控件和布局控件放置到里面，如下图所示：

 

 

 

      我们在 NET 中定义一个类，这个类用来实现这两个功能，类的名称是 ControlsSynchronizer

 

/// 在构造函数中传入地图控件和布局控件

 

public ControlsSynchronizer (IMapControl3_MapControl, IPageLayoutControl2 _PageLayoutControl): this ()

{

  //assign the class members pMapControl = _MapControl;

  pPageLayoutControl = \_PageLayoutControl;

}

 

/// 激活地图控件并销毁布局控件

public void ActivateMap ()

{

  try

  {

    if (pPageLayoutControl == null || pMapControl == null)

      throw new Exception ("ControlsSynchronizer::ActivateMap:\\r\\nEither MapControl or PageLayoutControl are not initialized!");

    //cache the current tool of the PageLayoutControl

 

    if (pPageLayoutControl.CurrentTool != null) pPageLayoutActiveTool = pPageLayoutControl.CurrentTool;

 

    //销毁PagleLayout

    pPageLayoutControl.ActiveView.Deactivate();

 

    //激活 MapControl

    pMapControl.ActiveView.Activate(pMapControl.hWnd);

 

    //将保留下来的工具付给MapControl

    if (pMapActiveTool != null) pMapControl.CurrentTool = pMapActiveTool;

    pIsMapControlactive = true;

    //on each of the framework controls, set the Buddy control to the MapControl this.SetBuddies

    (pMapControl.Object);

 

  } catch (Exception ex)

  {

    throw new Exception (string.Format ("ControlsSynchronizer::ActivateMap:\\r\\n{0}",

      ex.Message));

  }

}

 

/// 激活布局控件并销毁地图控件

 

public void ActivatePageLayout ()

{

  try

  {

    if (pPageLayoutControl == null || pMapControl == null)

      throw new Exception ("ControlsSynchronizer::ActivatePageLayout:\\r\\nEither MapControl or PageLayoutControl are not initialized!");

    //cache the current tool of the MapControl

    if (pMapControl.CurrentTool != null) pMapActiveTool = pMapControl.CurrentTool;

    //销毁 MapControl

    pMapControl.ActiveView.Deactivate();

 

    //激活 PageLayoutControl

    pPageLayoutControl.ActiveView.Activate(pPageLayoutControl.hWnd);

 

    //将保留下来的工具付给PageLayoutControl

 

    if (pPageLayoutActiveTool != null) pPageLayoutControl.CurrentTool = pPageLayoutActiveTool;

 

    pIsMapControlactive = false;

 

    //on each of the framework controls , set the Buddy control to the PageLayoutControl

 

    this.SetBuddies (pPageLayoutControl.Object);

  } catch (Exception ex)

  {

    throw new Exception (string.Format ("ControlsSynchronizer::ActivatePageLayout:\r\n{0}",ex.Message));

  }

}

 

/// 当激活的控件发生变化时,IToolbarControl控件和ITOCControl控件的伙伴控件也应发生变化

 

private void SetBuddies(object _buddy)

{

  try

  {

    if (_buddy == null)

      throw new Exception ("ControlsSynchronizer::SetBuddies:\r\nTarget Buddy Control is not initialized!");

 

    foreach (object obj in pFrameworkControls)

    {

      if (obj is IToolbarControl)

      {

        ((IToolbarControl) obj).SetBuddyControl (_buddy);

      } else if (obj is ITOCControl)

      {

        ((ITOCControl) obj).SetBuddyControl (_buddy);

      }

    }

  } catch (Exception ex)

  {

    throw new Exception (string.Format ("ControlsSynchronizer::SetBuddies:\r\n{0}",ex.Message));

  }

}

 

/// 如果地图发生了变化,那么地图控件和布局控件的地图也应发生变化

 

public void ReplaceMap(IMap _NewMap)

{

  if (_NewMap == null)

    throw new Exception ("ControlsSynchronizer::ReplaceMap:\\r\\nNew map for replacement is not initialized!");

  if (pPageLayoutControl == null || pMapControl == null)

    throw new Exception ("ControlsSynchronizer::ReplaceMap:\\r\\nEither MapControl or PageLayoutControl are not initialized!");

 

  //create a new instance of IMaps collection which is needed by the PageLayout

 

  IMaps pMaps = new Maps();

 

  //添加新的地图

  pMaps.Add(_NewMap);

  bool bIsMapActive = pIsMapControlactive;

  //call replace map on the PageLayout in order to replace the focus map

  //we must call ActivatePageLayout, since it is the control we call 'ReplaceMaps'

  this.ActivatePageLayout();

  pPageLayoutControl.PageLayout.ReplaceMaps (pMaps);

  //assign the new map to the MapControl

  pMapControl.Map = _NewMap;

 

  //reset the active tools

  pPageLayoutActiveTool = null;

  pMapActiveTool = null;

 

  //make sure that the last active control is activated

  if (bIsMapActive)

  {

    this.ActivateMap ();

    pMapControl.ActiveView.Refresh ();

  } else

  {

    this.ActivatePageLayout ();

    pPageLayoutControl.ActiveView.Refresh ();

  }

}

 

/// 当运行应用程序的时候,即便没有加载地图,则创建一个空的地图,让这两个控件和这 个地图绑定在一起,这样就能保持一致

 

public void BindControls (bool_ActivateMapFirst)

{

  if (pPageLayoutControl == null || pMapControl == null)

    throw new Exception ("ControlsSynchronizer::BindControls:\\r\\nEither MapControl or PageLayoutControl are not initialized!");

 

  //创建一个地图实例

  IMap pNewMap = new MapClass ();

  pNewMap.Name = "Map";

 

  //其中Maps为我们创建的一个类,表示的是地图的集合 IMaps

  pMaps = new Maps();

 

  //add the new Map instance to the Maps collection

  pMaps.Add(pNewMap);

 

  //call replace map on the PageLayout in order to replace the focus map

  pPageLayoutControl.PageLayout.ReplaceMaps(pMaps);

 

  //assign the new map to the MapControl

  pMapControl.Map = pNewMap;

 

  //reset the active tools

  pPageLayoutActiveTool = null;

  pMapActiveTool = null;

 

  //make sure that the last active control is activated

  if (_ActivateMapFirst)

    this.ActivateMap ();

  else

    this.ActivatePageLayout ();

}

      还记得我们上次创建的那个打开地图文档的命令？ 在打开地图的时候, 我们只不过是将这个地图付给 了 Map 控件, 这样的话布局控件是得不到图的, 因此应该对 OnClick 改动下, 在这个里面将 map 控件和布 局控件同步起来

 

public override void OnClick ()

{

  //launch a new OpenFile dialog

  OpenFileDialog dlg = new OpenFileDialog();

  dlg.Filter = "Map Documents (*.mxd)|*.mxd"; dlg.Multiselect = false;

  dlg.Title = "Open Map Document";

  if (dlg.ShowDialog () == DialogResult.OK)

  {

    string docName = dlg.FileName;

    IMapDocument pMapDoc = new MapDocumentClass ();

    if (pMapDoc.get_IsPresent (docName) &&!pMapDoc.get_IsPasswordProtected (docName))

    {

      pMapDoc.Open (docName, string.Empty);

      // set the first map as the active view

      IMap map = pMapDoc.get\_Map(0); pMapDoc.SetActiveView((IActiveView)map);

 

      pControlsSynchronizer.PageLayoutControl.PageLayout = pMapDoc.PageLayout;

      pControlsSynchronizer.ReplaceMap (map);

      pMapDoc.Close ();

      m_sDocumentPath = docName;

    }

  }

}

在ControlsSynchronizer类中使用的Maps类的代码如下：

 

namespace EngineApplication

{

  /// Implementation of interface IMaps which is eventually a collection of Maps

 

  public class Maps : IMaps, IDisposable

  {

    //class member - using internally an ArrayList to manage the Maps collection

    private ArrayList pArray = null;

    #region class constructor public Maps ()

    {

      pArray = new ArrayList ();

    }

    #endregion

    #region IDisposable Members

 

    /// Dispose the collection

 

    public void Dispose ()

    {

      if (pArray != null)

      {

        pArray.Clear ();

        pArray = null;

      }

    }

 

    #endregion

    #region IMaps Members

 

    /// Remove the Map at the given index

 

    public void RemoveAt(int Index)

    {

      if (Index & gt; pArray.Count || Index & lt; 0)

        throw new Exception ("Maps::RemoveAt:\r\nIndex is out of range!");

      pArray.RemoveAt (Index);

    }

 

    /// Reset the Maps array

 

    public void Reset()

    {

      pArray.Clear ();

    }

 

    /// Get the number of Maps in the collection

 

    public int Count

    {

      get

      {

        return pArray.Count;

      }

    }

 

    public IMap get_Item (int Index)

    {

      if (Index & gt; pArray.Count || Index & lt; 0)

 

        throw new Exception ("Maps::get_Item:\r\nIndex is out of range!");

      return pArray[Index] as IMap;

    }

 

    /// Remove the instance of the given Map

 

    public void Remove(IMap Map)

    {

      pArray.Remove (Map);

    }

 

    /// Create a new Map, add it to the collection and return it to the caller

 

    public IMap Create ()

    {

      IMap newMap = new MapClass ();

      pArray.Add (newMap);

      return newMap;

    }

 

    /// Add the given Map to the collection

 

    public void Add(IMap Map)

    {

      if (Map == null)

        throw new Exception ("Maps::Add:\\r\\nNew Map is mot initialized!");

      pArray.Add (Map);

    }

    #endregion

  }

}