ArcGISEngine10.0轻松入门级教程(2).doc

ArcGIS Engine10.0轻松入门级教程（2）创建一个ArcGIS Engine桌面应用程序分类：ArcEngine开发2012-06-17 12:441154人阅读评论(2)收藏举报目录(?)-1. 创建一个新的工程2. 添加控件3. 控件绑定4. 添加工具5. 添加菜单6. PageLayout与MapControl联动7. 鹰眼的实现8. 状态栏的实现9. 右键的实现10. 符号选择器的实现11. 图层文本标注这个例子将引导您创建第一个简单的地图显示程序，并添加基本的缩放和漫游功能。如果您之前没有接触过ArcGISEngine的开发，那么这个例子是您迈入ArcGISEngine二次开发大门的极好例子，如果您之前没有接触过C#.NET，也无需担心，这个例子将从零开始引导您一步一步完成任务。1创建一个新的工程首先打开MicrosoftVisualStudio2008，点击菜单栏中的“文件”“新建”“项目”，在弹出的对话框中选择新建一个VisualC#的Windows应用程序，之后更改项目名称为“ZZUMap”，更改文件的路径为个人实习文件夹，点击“确定”即可。 选中项目“ZZUMap”中的窗体“Form1”，修改其Name属性为“MainForm”，Text属性为“ZZUMap”。2添加控件选择工具箱中的“菜单和工具栏|MenuStrip”，将其拖入窗体。 选择工具箱中的“ArcGIS Windows Forms”节，将“ToolbarControl”控件拖入窗体，并将其属性中的Dock设置为Top。 选择工具箱中的“菜单和工具栏|StatusStrip”，将其拖入到窗体。 选择工具箱中的“容器|SplitContainer”容器拖入窗体，并将其属性中的Dock设置为Fill。再将“容器|SplitContainer”容器拖入Panel1，设置为水平拆分方向，并将其属性中的Dock设置为Fill。 将TabControl控件拖入Panel1，将Alignment属性设置为Bottom，Dock属性设置为Fill。点击TabPages属性右边的按钮，弹出TabPage集合编辑器，将tabPage1的Name设置为tabPageLayer，Text设置为图层，将tabPage2的Name设置为tabPageProperty，Text设置为属性。 选择“图层”选项卡，拖入TOCControl控件，设置Dock属性为Fill。 选择“属性”选项卡，拖入PropertyGrid设置Dock属性为Fill。 拖入TabControl控件到第一个SplitContainer容器的Panel2，设置Dock属性为Fill。并上述类似的方法，将两个选项卡的Name和Text分别设置为：（tabPageMap、地图），（tabPageLayout，制版）。 选择“地图”选项卡，拖入MapControl控件，设置Dock属性为Fill。 选择“制版”选项卡，拖入PageLayoutControl控件，设置Dock属性为Fill。 将MapControl控件拖入第二个SplitContainer容器的Panel2，设置Dock属性为Fill。 最后将LicenseControl控件拖入到窗体的任意地方。 按F5编译运行还不能运行，因为就很可能是你的ArcEngine10.0没有许可，因为我的就是这个情况，所以会报错，重新授权下就OK了，解决方法：打开program.cs 把ESRI.ArcGIS.RuntimeManager.Bind(ESRI.ArcGIS.ProductCode.EngineOrDesktop);这句放到Application.SetCompatibleTextRenderingDefault(false);和Application.Run(new Form1();之间。3控件绑定通过以上步骤添加的控件还只是单独存在，而我们的程序需要各控件间协同工作，因此要进行控件绑定。分别右击ToolbarControl、TOCControl控件，将Buddy设置为axMapControl1，如下图所示。这样，工具条和图层控件就与地图控件关联了。4添加工具此时，工具条中还没有任何工具，添加的方法也很简单。右击ToolbarControl，选择“属性|Items”，点击Add，选择Commands选项卡中的Generic，双击Open、SaveAs、Redo、Undo即可将相应工具添加到工具条。 常见的工具有： Map Navigation中的导航工具，Map Inquiry中的查询工具，Feature Selection中的选择工具，你可以根据需要酌情添加工具，如下图。目前为止运行程序界面如下：5添加菜单 在设计视图中，单击菜单栏，会出现“请在此处键入”的提示，单击提示就可以键入菜单名称，如“文件”，再单击“文件”，即可输入其下拉子菜单。 每创建一个菜单，请在其属性面板中设置 Name 属性，而且不要为中文，因此 Name 值将是此菜单响应函数的函数名的一部分，带中文的函数名，总是不好吧。我们将添加新建（ New ）、打开（ Open ）、添加数据（ AddData ）、保存（ Save ）、另存为（ SaveAs ）、退出（ Exit ）这些菜单，（）内为相应的 Name 属性值。 你可以在属性面板中的 Text 属性中，把菜单名设置为中英文形式，如“打开 O pen ”，带下划线的 O 表示此项菜单的快捷键是字母 O ，设置方法是在相应字母前加上“ & ”字符，如“打开 &Open ”。但这种快捷键只在打开此下拉菜单时才有效，即当你单击“文件”菜单弹出下拉菜单时，按下字母 O 就可以定位到“打开”菜单。 还有一种在程序运行时都有效的全局快捷键，可以在属性面板中的“ ShortCutKeys ”中设置。 你还可以在属性面板中的 Image 属性中设置你喜欢的菜单图标。单击 Image 那一行右边的按钮，弹出如下菜单。选择“项目资源文件”，再单击导入就可以选择你的图标了。 最终效果如下所示。注意，在解决方案面板中，选中刚才添加的所有图标，在其属性面板中将生成操作设置为“嵌入的资源”，这一点很重要！菜单的实现参考ArcEngine自带的模板MapControl Application中的菜单实现。先新建一个类，命名为CreateNewDocument.cs，添加引用： using ESRI.ArcGIS.ADF.BaseClasses; using ESRI.ArcGIS.ADF.CATIDs; using ESRI.ArcGIS.Controls; using ESRI.ArcGIS.Carto; using ESRI.ArcGIS.SystemUI; using System.Windows.Forms; 在构造函数中继承类：public class CreateNewDocument : BaseCommand； 然后将以下代码复制覆盖到类CreateNewDocument中 private IHookHelper m_hookHelper = null; /constructor public CreateNewDocument() /update the base properties base.m_category = .NET Application; base.m_caption = NewDocument; base.m_message = Create a new map; base.m_toolTip = Create a new map; base.m_name = DotNetTemplate_NewDocumentCommand; #region Overridden Class Methods / / Occurs when this command is created / / Instance of the application public override void OnCreate(object hook) if (m_hookHelper = null) m_hookHelper = new HookHelperClass(); m_hookHelper.Hook = hook; / / Occurs when this command is clicked / public override void OnClick() IMapControl3 mapControl = null; /get the MapControl from the hook in case the container is a ToolbarControl if (m_hookHelper.Hook is IToolbarControl) mapControl = (IMapControl3)(IToolbarControl)m_hookHelper.Hook).Buddy; /In case the container is MapControl else if (m_hookHelper.Hook is IMapControl3) mapControl = (IMapControl3)m_hookHelper.Hook; else MessageBox.Show(Active control must be MapControl!, Warning, MessageBoxButtons.OK, MessageBoxIcon.Exclamation); return; /check to see if there is an active edit session and whether edits have been made DialogResult result; IEngineEditor engineEditor = new EngineEditorClass(); if (engineEditor.EditState = esriEngineEditState.esriEngineStateEditing) & (engineEditor.HasEdits() = true) result = MessageBox.Show(Would you like to save your edits, Save Edits, MessageBoxButtons.YesNoCancel, MessageBoxIcon.Question); switch (result) case DialogResult.Cancel: return; case DialogResult.No: engineEditor.StopEditing(false); break; case DialogResult.Yes: engineEditor.StopEditing(true); break; /allow the user to save the current document DialogResult res = MessageBox.Show(Would you like to save the current document?, AoView, MessageBoxButtons.YesNo, MessageBoxIcon.Question); if (res = DialogResult.Yes) /launch the save command ICommand command = new ControlsSaveAsDocCommandClass(); command.OnCreate(m_hookHelper.Hook); command.OnClick(); /create a new Map IMap map = new MapClass(); map.Name = Map; /assign the new map to the MapControl mapControl.DocumentFilename = string.Empty; mapControl.Map = map; #endregion然后定义指针和变量： privEmpty;ate ESRI.ArcGIS.Controls.IMapControl4 m_mapControl = null;private ESRI.ArcGIS.Controls.IPageLayoutControl3 m_pageLayoutControl = null;private string m_mapDocumentName = string. 最后在菜单按钮的事件中填入以下代码： private void AddData_Click(object sender, EventArgs e) int currentLayerCount = this.axMapControl1.LayerCount; ICommand pCommand = new ControlsAddDataCommandClass(); pCommand.OnCreate(this.axMapControl1.Object); pCommand.OnClick(); private void Save_Click(object sender, EventArgs e) /execute Save Document command if (m_mapControl.CheckMxFile(m_mapDocumentName) /create a new instance of a MapDocument IMapDocument mapDoc = new MapDocumentClass(); mapDoc.Open(m_mapDocumentName, string.Empty); /Make sure that the MapDocument is not readonly if (mapDoc.get_IsReadOnly(m_mapDocumentName) MessageBox.Show(Map document is read only!); mapDoc.Close(); return; private void SavaAs_Click(object sender, EventArgs e) /execute SaveAs Document command ICommand command = new ControlsSaveAsDocCommandClass(); command.OnCreate(m_mapControl.Object); command.OnClick(); private void Open_Click(object sender, EventArgs e) /execute Open Document command ICommand command = new ControlsOpenDocCommandClass(); command.OnCreate(m_mapControl.Object); command.OnClick(); private void Exit_Click(object sender, EventArgs e) /exit the application Application.Exit(); private void New_Click(object sender, EventArgs e) /execute New Document command ICommand command = new CreateNewDocument(); command.OnCreate(m_mapControl.Object); command.OnClick(); 6PageLayout与MapControl联动 在ArcMap程序中，数据视图和布局视图中的数据改变是实时互动的，那是因为它们本来就是在处理同一份数据。将axMapControl1中的Map拷贝到axPageLayoutControl1代码如下：private voidCopyAndOverwriteMap()/Get IObjectCopy interfaceIObjectCopy objectCopy =newObjectCopyClass();/Get IUnknown interface (map to copy)object toCopyMap = axMapControl1.Map;/Get IUnknown interface (copied map)object copiedMap = objectCopy.Copy(toCopyMap);/Get IUnknown interface (map to overwrite)object toOverwriteMap = axPageLayoutControl1.ActiveView.FocusMap;/Overwrite the PageLayoutControls mapobjectCopy.Overwrite(copiedMap,reftoOverwriteMap);要实现axPageLayoutControl1中的数据与axMapControl1中的数据同步，需要在axMapControl1的以下事件中写入相应的代码：private voidaxMapControl1_OnMapReplaced(objectsender,ESRI.ArcGIS.MapControl.IMapControlEvents2_OnMapReplacedEvent e)CopyAndOverwriteMap();private voidaxMapControl1_OnAfterScreenDraw(objectsender,ESRI.ArcGIS.MapControl.IMapControlEvents2_OnAfterScreenDrawEvent e)/Get IActiveView interfaceIActiveView activeView = (IActiveView)axPageLayoutControl1.ActiveView.FocusMap;/Get IDisplayTransformation interfaceIDisplayTransformation displayTransformation =activeView.ScreenDisplay.DisplayTransformation;/Set the visible extent of the focus mapdisplayTransformation.VisibleBounds = axMapControl1.Extent;axPageLayoutControl1.ActiveView.Refresh(); /根据MapControl的视图范围,确定PageLayoutControl的视图范围CopyAndOverwriteMap();private voidaxMapControl1_OnViewRefreshed(objectsender,ESRI.ArcGIS.MapControl.IMapControlEvents2_OnViewRefreshedEvent e) /axTOCControl1.Update (); CopyAndOverwriteMap(); 运行但是axTOCControl控件图层不显示，这是因为还要设置SetBuddyControl，ToolBarControl控件中同样要设置，只需要在在主窗口Load函数中添加下面一句话就可以了 private void MainForm_Load(object sender, EventArgs e) axTOCControl1.SetBuddyControl(axMapControl1);/ADD axToolbarControl1.SetBuddyControl(m_mapControl); 7鹰眼的实现鹰眼用来显示主窗体当前视图范围在全景视图中的位置，在ArcMap中使用一个线框在鹰眼视图中标识。当主视图中的视图范围改变时，鹰眼中的线框随之改变，当拖动鹰眼视图中的红线框时，主视图中的视图范围也随之改变。下面开始实现鹰眼功能，添加usingESRI.ArcGIS.Carto、usingESRI.ArcGIS.Geometry、usingESRI.ArcGIS.Display三个引用。首先在axMapControl1中视图范围改变时鹰眼窗体要做出对应的响应，即绘制线框并显示，在OnExtentUpdated事件中添加代码如下：privatevoidaxMapControl1_OnExtentUpdated (objectsender,ESRI.ArcGIS.Controls.IMapControlEvents2_OnExtentUpdatedEvente)/创建鹰眼中线框IEnvelopepEnv=(IEnvelope)e.newEnvelope;IRectangleElementpRectangleEle=newRectangleElementClass();IElementpEle=pRectangleEleasIElement;pEle.Geometry=pEnv;/设置线框的边线对象，包括颜色和线宽IRgbColorpColor=newRgbColorClass();pColor.Red=255;pColor.Green=0;pColor.Blue=0;pColor.Transparency=255;/产生一个线符号对象ILineSymbolpOutline=newSimpleLineSymbolClass();pOutline.Width=2;pOutline.Color=pColor;/设置颜色属性pColor.Red=255;pColor.Green=0;pColor.Blue=0;pColor.Transparency=0;/设置线框填充符号的属性IFillSymbolpFillSymbol=newSimpleFillSymbolClass();pFillSymbol.Color=pColor;pFillSymbol.Outline=pOutline;IFillShapeElementpFillShapeEle=pEleasIFillShapeElement;pFillShapeEle.Symbol=pFillSymbol;/得到鹰眼视图中的图形元素容器IGraphicsContainerpGra=axMapControl2.MapasIGraphicsContainer;IActiveViewpAv=pGraasIActiveView;/在绘制前，清除axMapControl2中的任何图形元素pGra.DeleteAllElements();/鹰眼视图中添加线框pGra.AddElement(IElement)pFillShapeEle,0);/刷新鹰眼pAv.PartialRefresh(esriViewDrawPhase.esriViewGraphics,null,null); 当鼠标点击鹰眼窗体时，主窗体Extent随之改变。在axMapControl2的OnMouseDown事件中添加代码如下： privatevoidaxMapControl2_OnMouseDown(objectsender,ESRI.ArcGIS.Controls.IMapControlEvents2_OnMouseDownEvente)if(this.axMapControl2.Map.LayerCount!=0)/按下鼠标左键移动矩形框if(e.button=1)IPointpPoint=newPointClass();pPoint.PutCoords(e.mapX,e.mapY);IEnvelopepEnvelope=this.axMapControl1.Extent;pEnvelope.CenterAt(pPoint);this.axMapControl1.Extent=pEnvelope;this.axMapControl1.ActiveView.PartialRefresh(esriViewDrawPhase.esriViewGeography,null,null);/按下鼠标右键绘制矩形框elseif(e.button=2)IEnvelopepEnvelop=this.axMapControl2.TrackRectangle();this.axMapControl1.Extent=pEnvelop;this.axMapControl1.ActiveView.PartialRefresh(esriViewDrawPhase.esriViewGeography,null,null); 当鼠标在鹰眼窗体移动时，主窗体Extent随之改变。在axMapControl2的OnMouseMove事件中添加代码如下：privatevoidaxMapControl2_OnMouseMove(objectsender,ESRI.ArcGIS.Controls.IMapControlEvents2_OnMouseMoveEvente)/如果不是左键按下就直接返回if(e.button!=1)return;IPointpPoint=newPointClass();pPoint.PutCoords(e.mapX,e.mapY);this.axMapControl1.CenterAt(pPoint);this.axMapControl1.ActiveView.PartialRefresh(esriViewDrawPhase.esriViewGeography,null,null); 下面代码用于实现axMapControl2与axMapControl1的数据的同步更新，获取主视图中视图范围最大的图层作为鹰眼中的视图。这个更新由两部分组成，一个是对axMapControl1添加地图文档（mxd文件）的响应，通过axMapControl1的OnMapReplace事件实现，一个是对axMapControl1添加单个图层的响应，通过axMapControl1的OnFullExtentUpdated事件实现。我们获取主视图中的视图范围最大的图层写成一个独立的函数，方便调用。privateILayerGetOverviewLayer(IMapmap)/获取主视图的第一个图层ILayerpLayer=map.get_Layer(0);/遍历其他图层，并比较视图范围的宽度，返回宽度最大的图层ILayerpTempLayer=null;for(inti=1;imap.LayerCount;i+)pTempLayer=map.get_Layer(i);if(pLayer.AreaOfInterest.WidthpTempLayer.AreaOfInterest.Width)pLayer=pTempLayer;returnpLayer;然后在axMapControl1的OnMapReplaced事件中调用。privatevoidaxMapControl1_OnMapReplaced(objectsender,IMapControlEvents2_OnMapReplacedEvente)/获取鹰眼图层this.axMapControl2.AddLayer(this.GetOverviewLayer(this.axMapControl1.Map);/设置MapControl显示范围至数据的全局范围this.axMapControl2.Extent=this.axMapControl1.FullExtent;/刷新鹰眼控件地图this.axMapControl2.Refresh(); 在axMapControl1的OnFullExtentUpdated添加代码，用于实现在主视图添加图层时，实现对鹰眼视图的更新。代码如下：privatevoidaxMapControl1_OnFullExtentUpdated(objectsender,ESRI.ArcGIS.Controls.IMapControlEvents2_OnFullExtentUpdatedEvente)/获取鹰眼图层this.axMapControl2.AddLayer(this.GetOverviewLayer(this.axMapControl1.Map);/设置MapControl显示范围至数据的全局范围this.axMapControl2.Extent=this.axMapControl1.FullExtent;/刷新鹰眼控件地图this.axMapControl2.Refresh();this.axMapControl2.Map=newMapClass();/添加主地图控件中的所有图层到鹰眼控件中for(inti=1;i=this.axMapControl1.LayerCount;i+)this.axMapControl2.AddLayer(this.axMapControl1.get_Layer(this.axMapControl1.LayerCount-i);/设置MapControl显示范围至数据的全局范围this.axMapControl2.Extent=this.axMapControl1.FullExtent;/刷新鹰眼控件地图this.axMapControl2.Refresh(); 运行程序，添加地图数据，可以在主视图进行相关操作，鹰眼视图同步响应，在鹰眼视图可以移动红线框可以同步更新主视图的视图范围，在鹰眼视图单击右键拉框可以重新绘制红线框，效果如下：8状态栏的实现应用程序的状态栏一般用来显示程序的当前状态，当前所使用的工具。 GIS 应用程序一般也在状态栏显示当前光标的坐标、比例尺等信息。学习完本讲内容，您将学会状态栏编程的基本方法，并且能够在我们的程序的状态栏中添加且显示以下信息： 当前所用工具信息当前比例尺 当前坐标 在设计视图中，点击窗体中的状态栏，在其属性面板中找到“ Items ”项，单击其右边的按钮，在下拉框中选择“ StatusLabel ”，单击“添加按钮”，依次添加四个 StatusLabel ，依次修改属性参数如下表所示： 序号Name 属性 Text 属性 Spring 属性 说明 1 MessageLabel 就绪 False 当前所用工具信息 2 Blank True 占位 3 ScaleLabel 比例尺 False 当前比例尺 4 CoordinateLabel 当前坐标 False 当前坐标 设置好之后如下图所示：Spring 属性表示可以按状态栏剩余空间自动伸缩。所以加入 Blank 项目，只是为了占个位子，以达到 ScaleLabel 和 CoordinateLabel 项目右对齐而 MessageLabel 项目左对齐的目的。 首先添加 axToolbarControl1 的 OnMouseMove 事件 ( 相信大家看了以上的教程，已经知道怎么添加事件了吧，还不知道的建议再温习下前几讲的内容 ) 。在其事件响应函数代码如下：private void axToolbarControl1_OnMouseMove(object sender, IToolbarControlEvents_OnMouseMoveEvent e)/ 取得鼠标所在工具的索引号int index = axToolbarControl1.HitTest(e.x, e.y, false);if (index != -1)/ 取得鼠标所在工具的 ToolbarIt