基于AE的SimpleGIS框架的搭建

ArcGIS是Esri公司集40余年地理信息系统（GIS）咨询和研发经验，奉献给用户的一套完整的GIS平台产品，具有强大的地图制作、空间数据管理、空间分析、空间信息整合、发布与共享的能力。本人主要就AE搭建框架做简单的介绍

框架是指一个系统的全部或部分可复用设计，通常由一组抽象类和类之间的协助组成，其有几个特点。

1.模块化：应用框架可以从逻辑上划分为若干个不同的功能模块。

2.可重用性：代码的可重用性是衡量代码健壮性的一个标志，无论是函数，类，接口，还是其他更高层次的模型，都是为了提高其重用性。

3.可扩展性：可扩展性是应用框架一个最显著地标志，他意味着框架的能力具有可生长性。

其实arcmap也是一个可以扩展的框架，下面我们通过对arcmap的框架的研究来学习如何搭建自己的框架

首先我们打开arcmap编写一个简单的宏

宏命名为zoomin--实现一个简单的放大功能

 Dim imxdocument As imxdocument
 Dim penovlop As IEnvelope
 Set imxdocument = ThisDocument
 Set penovlop = imxdocument.ActiveView.Extent
 penovlop.Expand 0.2, 0.2, True
 imxdocument.ActiveView.Extent = penovlop
 imxdocument.ActiveView.Refresh

保存宏，在菜单--自定义--自定义模式--工具条  新建工具条

我们在arcmap工具条看到一个新的工具栏，

在菜单--自定义--自定义模式--命令  找到 --宏   将我们刚才写的宏拖到菜单栏，这样我们就实现 了一个简单的功能

如此可见arcmap是一个可拓展的框架

2.通过实现接口或者抽象类的方法实现arcgis功能

如图安装了arcgis后 可以使用arcgis addin 来扩展功能

 namespace ClassLibrary1
 {
     /// <summary>
     /// Command that works in ArcMap/Map/PageLayout
     /// </summary>
     [Guid("86fbcea5-043b-404a-a00c-5c480b42f51e")]
     [ClassInterface(ClassInterfaceType.None)]
     [ProgId("ClassLibrary1.Command1")]
     public sealed class Command1 : BaseCommand
     {
         // 将.net 注册为com函数
         #region COM Registration Function(s)
         [ComRegisterFunction()]
         [ComVisible(false)]
         static void RegisterFunction(Type registerType)
         {
             // Required for ArcGIS Component Category Registrar support
             ArcGISCategoryRegistration(registerType);

             //
             // TODO: Add any COM registration code here
             //
         }

         [ComUnregisterFunction()]
         [ComVisible(false)]
         static void UnregisterFunction(Type registerType)
         {
             // Required for ArcGIS Component Category Registrar support
             ArcGISCategoryUnregistration(registerType);

             //
             // TODO: Add any COM unregistration code here
             //
         }

         #region ArcGIS Component Category Registrar generated code
         /// <summary>
         /// Required method for ArcGIS Component Category registration -
         /// Do not modify the contents of this method with the code editor.
         /// </summary>
         private static void ArcGISCategoryRegistration(Type registerType)
         {
             string regKey = string.Format("HKEY_CLASSES_ROOT\\CLSID\\{{{0}}}", registerType.GUID);
             MxCommands.Register(regKey);
             ControlsCommands.Register(regKey);
         }
         /// <summary>
         /// Required method for ArcGIS Component Category unregistration -
         /// Do not modify the contents of this method with the code editor.
         /// </summary>
         private static void ArcGISCategoryUnregistration(Type registerType)
         {
             string regKey = string.Format("HKEY_CLASSES_ROOT\\CLSID\\{{{0}}}", registerType.GUID);
             MxCommands.Unregister(regKey);
             ControlsCommands.Unregister(regKey);
         }

         #endregion
         #endregion

         private IHookHelper m_hookHelper = null;
         public Command1()
         {
             // 初始化
             // TODO: Define values for the public properties
             //
             base.m_category = ""; //localizable text
             base.m_caption = "";  //localizable text
             base.m_message = "This should work in ArcMap/MapControl/PageLayoutControl";  //localizable text
             base.m_toolTip = "";  //localizable text
             base.m_name = "";   //unique id, non-localizable (e.g. "MyCategory_MyCommand")

             try
             {
                 //
                 // TODO: change bitmap name if necessary
                 //
                 string bitmapResourceName = GetType().Name + ".bmp";
                 base.m_bitmap = new Bitmap(GetType(), bitmapResourceName);
             }
             catch (Exception ex)
             {
                 System.Diagnostics.Trace.WriteLine(ex.Message, "Invalid Bitmap");
             }
         }

         #region Overridden Class Methods

         /// <summary>
         /// Occurs when this command is created
         /// </summary>
         /// <param name="hook">Instance of the application</param>
         public override void OnCreate(object hook)
         {
             //重写基类
             if (hook == null)
                 return;

             try
             {
                 m_hookHelper = new HookHelperClass();
                 m_hookHelper.Hook = hook;
                 if (m_hookHelper.ActiveView == null)
                     m_hookHelper = null;
             }
             catch
             {
                 m_hookHelper = null;
             }

             if (m_hookHelper == null)
                 base.m_enabled = false;
             else
                 base.m_enabled = true;

             // TODO:  Add other initialization code
         }

         /// <summary>
         /// Occurs when this command is clicked
         /// </summary>
         public override void OnClick()
         {
             //全图显示
             IMapControl2 Pmapcontrol2 = m_hookHelper as IMapControl2;
             Pmapcontrol2.Extent = Pmapcontrol2.FullExtent;
             Pmapcontrol2.Refresh();
         }

         #endregion
     }
 }
生成dll文件，将其bin下面的 tlb.格式的文件 加载到 arcmap

二：基于simplegis的水电工程系统

初始化

  #region 私有变量
         IDockableMapWindow m_pMapDockWindow = null;
         private IFramework m_pFramework = null;
         private ITocWindow m_pTocWindow = new TocWindow();
         private bool m_bCanceledExit = false;
         //private License m_pLicense = null;
         #endregion

         #region 构造函数和窗体事件函数
         public MainForm()
         {
             //ESRI.ArcGIS.RuntimeManager.Bind(ESRI.ArcGIS.ProductCode.Engine);
             ESRI.ArcGIS.RuntimeManager.BindLicense(ESRI.ArcGIS.ProductCode.EngineOrDesktop);
             //this.m_pLicense = System.ComponentModel.LicenseManager.Validate(typeof(MainForm), this);
             m_pMapDockWindow = new MapDockWindow();
             this.Controls.Add(m_pMapDockWindow as Control);

             InitializeComponent();
             this.Load += new EventHandler(MainForm_Load);
             this.FormClosing += new FormClosingEventHandler(MainForm_FormClosing);
             (m_pMapDockWindow as Control).Dock = DockStyle.Fill;

             #region 初始化框架
             this.m_pFramework = new FrameworkClass();
             this.m_pFramework.MdiForm = this;
             IBarManager pBarManager = new BarManagerClass();
             pBarManager.BarManager = this.barManager1;
             IDockManager pDockManager = new DockManagerClass();
             pDockManager.DockManager = this.barManager1;
             this.m_pFramework.BarManager = pBarManager;
             this.m_pFramework.DockManager = pDockManager;
             //(this.m_pFramework as ICommandLineManager).CommandLineWindow = this.m_frmCommandLine;
             #endregion

             #region 命令工具栏赋值
             //this.m_frmCommandLine.Framework = this.m_pFramework;
             //this.m_frmCommandLine.DockManager = this.dockPanel1;
             #endregion

             # region 加载TOC
             DockableTocControl ctrToc = new DockableTocControl();
             IContentsViewManager pContensViewManager = ctrToc as IContentsViewManager;
             IContentsView pContentsView = new DisplayWindow();
             pContensViewManager.AddContentsView(pContentsView);
             pContentsView = new DataSourceWindow();
             pContensViewManager.AddContentsView(pContentsView);
             pContentsView = new CatalogWindow();
             pContensViewManager.AddContentsView(pContentsView);
             pContentsView = new VisibleWindow();
             pContensViewManager.AddContentsView(pContentsView);
             pContentsView = new SelectionView();
             pContensViewManager.AddContentsView(pContentsView);

             pDockManager.DockWindow(ctrToc as IDockableWindow);
             IDockableWindow pDockableWindow = pDockManager.GetDockableWindow((ctrToc as IDockableWindow).ID);
             this.m_pTocWindow.Toc = pDockableWindow;
             this.m_pTocWindow.DockManager = this.barManager1;
             this.m_pFramework.OverviewWindow = pContensViewManager.OverviewWindow;
             this.m_pFramework.TocWindow = this.m_pTocWindow;
             #endregion

             #region 加载地图控件
             this.m_pFramework.DelayEvents(true);
             this.m_pFramework.Hook = this.m_pMapDockWindow.Hook;
             this.m_pFramework.ActiveMapControl = this.m_pMapDockWindow.ActiveMapControl;

             #endregion
             #region 加载命令窗体

             #endregion

             #region 符号库
             IStyleGallery pStyleGallery = new StyleGalleryClass();

             string sStyleFile = Application.StartupPath + @"\SimpleGIS.style";
             if (System.IO.File.Exists(sStyleFile))
             {
                 (pStyleGallery as IStyleGalleryStorage).AddFile(sStyleFile);
             }
             (pStyleGallery as IStyleGalleryStorage).TargetFile = sStyleFile;
             //if (System.IO.File.Exists(Application.StartupPath + @"\Civic.ServerStyle"))
             //{
             //    (pStyleGallery as IStyleGalleryStorage).AddFile(Application.StartupPath + @"\Civic.ServerStyle");
             //}
             this.m_pFramework.StyleGallery = pStyleGallery;
             #endregion

             #region 绑定图层显示控件和鹰眼图
             this.m_pTocWindow.ContentsViewManager.SetBuddyControl(this.m_pMapDockWindow.Hook, this.m_pFramework);
             IOverviewWindow pOverviewWindow = this.m_pTocWindow.ContentsViewManager.OverviewWindow;
             if (pOverviewWindow != null)
             {
                 pOverviewWindow.MainActiveView = this.m_pFramework.Application.ActiveView;
                 pOverviewWindow.StyleGallery = this.m_pFramework.Application.StyleGallery;
                 pOverviewWindow.Framework = this.m_pFramework;
             }
             #endregion

             #region 创建状态栏
             StatusStrip ctrSta = new StatusStrip();
             ctrSta.Dock = DockStyle.Bottom;
             ToolStripStatusLabel lblToolTip = new ToolStripStatusLabel();
             ctrSta.Items.Add(lblToolTip);
             ToolStripStatusLabel lblMapPosition = new ToolStripStatusLabel();
             lblMapPosition.Spring = true;
             lblMapPosition.TextAlign = System.Drawing.ContentAlignment.MiddleRight;
             ctrSta.Items.Add(lblMapPosition);
             this.Controls.Add(ctrSta);
             IStatusBar pStatusBar = new StatusBarClass();
             pStatusBar.StatusBarControl = ctrSta;
             pStatusBar.BarMessageItem = lblToolTip;
             pStatusBar.BarMousePositionItem = lblMapPosition;

             pBarManager.StatusBar = pStatusBar;

             #endregion

             #region 加载插件
             string sMainFrameCommands = ConfigurationManager.AppSettings["PluginFile"];
             pBarManager.CreateToolBar(Application.StartupPath + "\\" + sMainFrameCommands);
             #endregion

             #region 绑定右键菜单控件
             pOverviewWindow = this.m_pFramework.OverviewWindow;
             if (pOverviewWindow is IControlContextMenu)
             {
                 pBarManager.RegisterControlWithPopupContext(pOverviewWindow as IControlContextMenu);
                 IControlContextMenu2 pControlContextMenu = pOverviewWindow as IControlContextMenu2;
                 pControlContextMenu.Clear();
                 pControlContextMenu.AddItem("RefreshOverview", false);
                 pControlContextMenu.AddItem("Overview", false);
                 pControlContextMenu.AddItem("OverviewWindowProperty", true);
             }
             if (this.m_pTocWindow.ContentsViewManager != null)
             {
                 for (int i = ; i < this.m_pTocWindow.ContentsViewManager.Count; i++)
                 {
                     IContentsView pView = this.m_pTocWindow.ContentsViewManager.ContentsView(i);
                     if (pView is IControlContextMenu)
                     {
                         pBarManager.RegisterControlWithPopupContext(pView as IControlContextMenu);
                     }
                 }
             }
             #endregion
         }

         private void MainForm_Load(object sender, EventArgs e)
         {
             try
             {
                 this.Text = ConfigurationManager.AppSettings["AppName"];
             }
             catch (Exception)
             {
             }
             //初始化一个当前工具
             ICommand pCommand = this.m_pFramework.FindCommand("SelectElementTool");
             if (pCommand is ITool)
             {
                 this.m_pFramework.CurrentTool = pCommand as ITool;
             }

             ////打开配置文件中指定的MXD文档
             //string sMxd = ConfigurationManager.AppSettings["Mxd"];
             //pCommand = this.m_pFramework.FindCommand("OpenDocumentCommand");
             //if (pCommand != null && System.IO.File.Exists(sMxd))
             //{
             //    IMxdFile pMxdFile = pCommand as IMxdFile;
             //    if (pMxdFile != null)
             //    {
             //        pMxdFile.MxdPath = sMxd;
             //        pMxdFile.Open();
             //    }
             //}
             this.m_pFramework.DelayEvents(false);
         }

         private void MainForm_FormClosing(object sender, FormClosingEventArgs e)
         {
             ICommand pCommand = this.m_pFramework.FindCommand("ExitApplication");
             if (pCommand != null)
             {
                 if (pCommand is IExitApplicationEvents)
                 {
                     (pCommand as IExitApplicationEvents).CancelExitApplicationEvent += new OnCancelExitApplicationEventHandler(MainForm_CancelExitApplicationEvent);
                 }
                 e.Cancel = this.m_bCanceledExit;
             }
         }

         void MainForm_CancelExitApplicationEvent(bool bCanceledExit)
         {
             this.m_bCanceledExit = bCanceledExit;
         }
         #endregion
     }

功能配置：

系统会自动检测配置功能