ArcGIS.Engine.Demo.MapViewer

### ArcGIS.Engine.Demo.MapViewer知识点详解 #### 一、项目概述 **ArcGIS.Engine.Demo.MapViewer** 是一个基于ArcGIS Engine开发平台的应用程序示例。该项目主要目的是展示如何利用ArcGIS Engine的各种控件来构建一个具备基本GIS功能的地图查看器。通过此示例项目，开发者可以学习到如何集成地图显示、导航、图层管理等功能。 #### 二、项目搭建步骤 1. **创建新项目** - 需要在开发环境中（如Visual Studio）创建一个新的ArcGIS Engine项目。 - 项目命名为`MapViewer`。 2. **添加控件** - 在工具箱(`Toolbox`)中添加以下控件： - `AxLicenseControl`: 负责管理许可证验证。 - `AxMapControl`: 主要用于显示地图。 - `AxPageLayoutControl`: 提供页面布局功能，可以用来加载MXD文件等。 - `AxTOCControl`: 图层目录控制，用于管理和显示地图中的各个图层。 - `AxToolbarControl`: 工具栏控件，提供常用的地图操作功能。 3. **添加GIS引用** - 添加以下ESRI ArcGIS库的引用，以便在项目中使用相应的GIS功能： - `ESRI.ArcGIS.ADF`: 提供了基础框架类。 - `ESRI.ArcGIS.Carto`: 与地图绘制相关的类库。 - `ESRI.ArcGIS.Display`: 显示相关类库。 - `ESRI.ArcGIS.Geometry`: 几何对象类库。 - `ESRI.ArcGIS.Output`: 输出相关类库。 - `ESRI.ArcGIS.System`: 系统服务类库。 - `ESRI.ArcGIS.SystemUI`: 用户界面类库。 4. **调整表单** - 重命名默认的表单`Form1`为`MapViewer`。 - 在设计模式下打开`MapViewer`窗体，从工具箱中拖拽MenuStrip控件到窗体上。 - 双击`LicenseControl`控件，然后将`MapControl`、`PageLayoutControl`、`TOCControl`和`ToolbarControl`控件添加到窗体中。 5. **调整窗体大小** - 根据实际需求调整`MapViewer`窗体的大小。 6. **导入GIS引用** - 在代码中导入所需的GIS类库引用： ```vbnet Imports ESRI.ArcGIS.Carto Imports ESRI.ArcGIS.Controls Imports ESRI.ArcGIS.Display Imports ESRI.ArcGIS.Geometry Imports ESRI.ArcGIS.SystemUI Imports ESRI.ArcGIS.esriSystem ``` 7. **初始化LicenseControl控件** - 右键点击`LicenseControl`控件，选择“ActiveX-Properties”打开属性页。 - 在属性页中选择产品许可级别，这里选择`ArcGIS Engine`作为许可类型。 8. **加载地图到控件** - 在`Form_Load`事件中，加载预先定义好的地图文档到`PageLayoutControl`控件中： ```vbnet Private Sub MapViewer_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load ' 加载预定义的地图文档到PageLayoutControl控件中 Dim sFileName As String = "D:\arcgis\ArcTutor\ArcReaderandPublisher\GulfofSt.Lawrence.mxd" If AxPageLayoutControl1.CheckMxFile(sFileName) Then AxPageLayoutControl1.LoadMxFile(sFileName) End If End Sub ``` - 在`PageLayoutControl`的`OnPageLayoutReplaced`事件处理程序中，将同样的地图文档加载到`MapControl`控件中，并设置其范围为数据的最大范围： ```vbnet Private Sub AxPageLayoutControl1_OnPageLayoutReplaced(ByVal sender As System.Object, ByVal e As ESRI.ArcGIS.Controls.IPageLayoutControlEvents_OnPageLayoutReplacedEvent) Handles AxPageLayoutControl1.OnPageLayoutReplaced ' 将相同的预定义地图文档加载到MapControl控件中 AxMapControl1.LoadMxFile(AxPageLayoutControl1.DocumentFilename) ' 设置MapControl的范围为数据的最大范围 AxMapControl1.Extent = AxMapControl1.FullExtent End Sub ``` 9. **设置TOCControl和ToolbarControl的BuddyControls属性** - 在`Form_Load`事件中，设置`TOCControl`和`ToolbarControl`控件的`BuddyControls`属性，以实现控件间的交互功能： ```vbnet Private Sub MapViewer_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load ' 设置TOCControl和ToolbarControl的BuddyControls属性 AxTOCControl1.BuddyControl = AxMapControl1 AxToolbarControl1.BuddyControl = AxMapControl1 End Sub ``` #### 三、总结 通过上述步骤，我们可以成功地创建一个具备基本地图查看功能的ArcGIS Engine应用。这个示例不仅展示了如何集成各种ArcGIS Engine控件，还演示了如何加载和管理地图数据，这对于初学者来说是非常有用的实践案例。此外，通过深入研究这些控件的功能和属性，开发者还可以进一步扩展该应用的功能，例如增加用户交互、地理编码查询等功能。