C#,ArcGIS Engine開發入門教程

阿新 • • 發佈：2019-02-08

利用ArcGIS Engine、VS .NET和Windows控制元件開發GIS應用

Dixon整理

此過程說明適合那些使用.NET建立和部署應用的開發者，它描述了使用ArcGIS控制元件建立和部署應用的方法和步驟。

你可以在下面的目錄下找到相應的樣例程式：

<安裝目錄>/DeveloperKit/Samples/Developer_Guide_Scenarios/ ArcGIS_Engine/Building_an_ArcGIS_Control_Application/Map_Viewer

注：ArcGIS樣例程式不包含在ArcGIS Engine開發工具包“典型”安裝方式中。如果你沒有安裝它們，則可以重新執行開發工具包安裝嚮導，選擇“定製”或“修改”方式，並選擇軟體開發包下的樣例項進行安裝。

一、專案描述

利用視窗控制元件建立應用程式的目標是演示並使你熟悉在微軟Visual Studio .NET API中使用標準ArcGIS控制元件開發和部署GIS應用所需的步聚。本節中使用了Visual Studio .NET開發環境中的MapControl、 PageLayoutControl、TOCControl和ToolbarControl等視窗控制元件。COM、Java和C++程式設計師應該參考如下章節：。

本節演示了建立檢視ArcMap和ArcGIS桌面應用圖形文件的GIS應用程式的步驟。此節包含了以下技術：

l在微軟Visual Studio .NET中載入和嵌入ArcGIS控制元件。

l向PageLayoutControl和MapControl中載入圖形文件。

l設定ToolbarControl和TOCControl的繫結控制元件。

l處理視窗縮放。

l向ToolbarControl新增ArcGIS Engine命令和工具。

l建立彈出式選單

l在TOCControl中管理標籤編輯

l在MapControl中繪製圖形。

l為MapControl、PageLayoutControl和ToolbarControl建立定製工具。

l使用者化ToolbarControl。

l在Windows作業系統中部署應用。

二、概述

本方案使用微軟Visual Studio .NET開發環境加以實現，並使用了ESRI interop

程式集(Interop Assemblies)，它服務於被放置在.NET窗體上的、位於.NET 窗體控制元件(.NET Windows Controls)中的ArcGIS控制元件，這些程式集在託管的.NET程式碼和非託管的COM程式碼之間起了橋樑作用。對COM ArcGIS控制元件(COM ArcGIS Controls)成員的引用都要經過Interop程式集，然後到達實際的COM物件。同樣，也從COM物件經過Interop程式集到達.NET應用程式。每個ArcGIS Engine控制元件具有方法、屬性與事件，它們能夠被控制元件嵌入的容器(如，.NET窗體)訪問。每個控制元件物件及其功能可以與其他ESRI ArcObjects和自定義控制元件組合使用，建立使用者化的客戶應用程式。

此方案是使用了C#和Visual Basic .NET兩種語言建立，但以下技術實現集中傾向於C#方案。許多開發者可能會感覺用Visual Basic .NET更舒服，那是因為他們已經比較熟悉Visual Basic 6.0程式碼，然而，對於Java和C++程式設計師來說，他們將會覺得對C#程式語言的語法更熟悉。無論你使用哪種開發環境，對於使用ArcGIS控制元件的好壞既依賴於你的程式設計環境技術，也依賴於你所掌握的ArcObjects技術。

在本方案中，使用ToolbarControl、TOCControl、PageLayoutControl和MapControl來為應用程式提供使用者介面。這些ArcGIS控制元件與其他ArcObjects和ArcGIS Engine命令被開發者一起使用，用來建立一個GIS視窗應用。

三、設計

此方案在設計時，首先強調了ArcGIS 控制元件如何互相之間進行互動，其次，向開發者解釋說明了ArcGIS 控制元件物件模型的一部分。

每個.NET ArcGIS Engine控制元件包含有一套能夠被嵌入其內的視窗即時訪問的屬性頁。這些屬性些為控制元件屬性和方法的選擇提供了捷徑，並且允許開發者不寫任何程式碼即可建立一個應用程式。本方案並沒有使用屬性頁，而是採用寫程式碼的方式建立應用程式。關於屬性頁的更進一步的資訊，請參考ArcGIS開發幫助(ArcGIS Developer Help)。

四、條件需求

要順利地完成以下方案，你需要以下條件（對於部署的需求將在後續的部署章節涉及到）：

l安裝具有授權檔案的ArcGIS Engine開發工具包(Developer Kit)，使之能夠用於開發。

l安裝有微軟Visual Studio .NET 2003開發環境和微軟.NET Framework 1.1及其相應協議。

l熟悉微軟Windows作業系統和Microsoft Visual Studio .NET的工作知識，會用C#或Visual Basic .NET程式語言。當然，此方案中提供了一些如何在Microsoft Visual Studio .NET中使用ArcGIS控制元件的資訊，但它不能替代對開發環境的培訓。

l不需要對ESRI其它軟體有足夠的經驗，但如果以前對ArcObjects有所接觸並對ArcGIS應用(如，ArcCatalog，ArcMap)有一個基本瞭解，則對於開發更有利。

l訪問來自本方案的樣例資料和程式碼，它位於：

<安裝目錄>/DeveloperKit/Samples/Developer_Guide_Scenarios/ ArcGIS_Engine/Building_an_ArcGIS_Control_Application/Map_Viewer

本方案中使用到的控制元件和庫如下：

lAxMapControl	lAxTOCControl
lAxPageLayoutControl	lAxToolbarControl
lESRI.ArcGIS.Carto	lESRI.ArcGIS.System
lESRI.ArcGIS.Display	lESRI.ArcGIS.SystemUI
lESRI.ArcGIS.Geometry	lESRI.ArcGIS.Utility
lesriMapControl	lesriTOCControl
lesriPageLayoutControl	lesriToolbarControl

五、實現

下面的實現過程中提供了你成功完成方案所需所有程式碼。假設你對於開發環境已經有了一定的知識，所以下面沒有逐步地詳細介紹如何用Microsoft Visual Studio .NET開發應用。

(一) 載入ArcGIS控制元件

在你為應用程式編寫程式碼之前，應該先將應用程式將用到的ArcGIS控制元件和其他ArcGIS Engine庫引用裝載到開發環境之中。

1. 啟動Visual Studio .NET，並從新建專案對話方塊中建立一個新的Visual C# “Windows應用程式”專案。

2. 將專案命名為“Controls”，並選擇位置存取該專案。

3. 在“工具箱”的“Windows窗體”標籤欄中單擊右鍵，然後從上下文選單中選擇“新增/移除項(I)…”。

4. 在“自定義工具箱”中選擇“.NET Framework元件”，並複選“AxMapControl”，“AxPageLayoutControl”，“AxTOCControl”和“AxToolbarControl”，單擊確定按鈕。這樣所選擇的控制元件將顯示在工具箱的Windows窗體標籤欄中。

5. 單擊專案選單，並選擇“新增引用(R)…”。

6. 在新增引用對話方塊中，雙擊“ESRI.ArcGIS.Carto”，“ESRI.ArcGIS.Display”，“ESRI.ArcGIS.Geometry”，“ESRI.ArcGIS.System”，“ESRI.ArcGIS.SystemUI”，“ESRI.ArcGIS.Utility”。單擊確定。

注：對於ESRI .NET程式集，將通過具體例項來說明，並使用.NET框架提供的COM傳送服務從你的C#專案中呼叫ESRI物件庫中的實體物件。

(二) 在容器中嵌入ArcGIS控制元件

在你能夠訪問每個控制元件的事件、屬性和方法之前，需要將控制元件嵌入到.NET容器中。一旦將控制元件嵌入窗體內，它們將圖形化應用程式的使用者介面。

1. 在設計模式下開啟.NET窗體。

2. 雙擊工具箱Windows標籤欄中的AxMapControl控制元件，將MapControl加入到窗體上。

3. 再將AxPageLayoutControl、AxTOCControl和AxToolbarControl如上新增到窗體中。

4. 重新調整窗體上各個控制元件的大小和位置，調整結果如下所示。

5. 在窗體上雙擊顯示窗體程式碼視窗，在程式碼視窗的頂部增加“using”命令：

using System;

using System.Windows.Forms;

// ArcGIS Engine引用

using ESRI.ArcGIS.SystemUI;

using ESRI.ArcGIS.Carto;

using ESRI.ArcGIS.Display;

using ESRI.ArcGIS.Geometry;

using ESRI.ArcGIS.esriSystem;

using ESRI.ArcGIS.ToolbarControl;

using ESRI.ArcGIS.TOCControl;

注：需注意C#是區分大小寫的。當你鍵入“ESRI.”時，智慧敏感的自動完成功能將允許你通過按Tab鍵完成下一節。

(三) 載入Map文件到MapControl與PageLayoutControl

單獨的資料層或者使用ArcMap、ArcGIS桌面應用程式產生的圖形文件，能夠被載入到MapControl和PageLayoutControl中。你可以載入樣例圖形文件，或者載入你自己的圖形文件。後面你將增加一個瀏覽圖形文件的對話方塊。

1. 選擇Form_Load事件，並輸入下列程式碼（如果你使用你自己的圖形文件，要替換為正確的檔名）：

// 使用相對路徑向PageLayoutControl載入一個圖形文件

string filename = @"../../../../../../../../Data//ArcGIS_Engine_Developer_Guide//gulf of st. lawrence.mxd";

if ( axPageLayoutControl1.CheckMxFile(filename) )

{

axPageLayoutControl1.LoadMxFile(filename, "");

}

2. 在設計模式顯示窗體並從屬性窗選擇axPageLayoutControl1控制元件，顯示axPageLayoutControl事件。在OnPageLayoutReplaced事件上雙擊向程式碼視窗新增該事件的處理函式。

3.在axPageLayoutControl1_OnPageLayoutReplaced事件中鍵入以下向MapControl載入樣例圖形文件的程式碼。當文件被裝載入PageLayoutControl時OnPageLayoutReplaced事件將會被觸發。

private void axPageLayoutControl1_OnPageLayoutReplaced(object sender, ESRI.ArcGIS.PageLayoutControl.IPageLayoutControlEvents_OnPageLayoutReplacedEvent e)

{

// 載入同樣的文件到MapControl

axMapControl1.LoadMxFile(axPageLayoutControl1.DocumentFilename, null, null);

// 設定MapControl顯示範圍至資料的全域性範圍

axMapControl1.Extent = axMapControl1.FullExtent;

}

(四) 設定ToolbarControl與TOCControl控制元件的繫結控制元件

對於此應用程式，TOCControl和ToolbarControl控制元件將與PageLayoutControl相互協作，而不是MapControl。為此PageLayoutControl必須設定為繫結控制元件。TOCControl使用繫結的ActiveView顯示圖形、圖層和符號。而位於ToolbarControl上的任何命令、工具或選單項會受繫結控制元件的顯示影響。

1. 在Form_Load事件中的載入文件程式碼的後面鍵入以下紅色部分內容：

private void Form1_Load(object sender, System.EventArgs e)

{

// 使用相對路徑向PageLayoutControl載入一個圖形文件

string filename = @"../../../../../../../../Data//ArcGIS_Engine_Developer_Guide//gulf of st. lawrence.mxd";

if ( axPageLayoutControl1.CheckMxFile(filename) )

{

axPageLayoutControl1.LoadMxFile(filename, "");

}

// 設定繫結控制元件

axTOCControl1.SetBuddyControl(axPageLayoutControl1);

axToolbarControl1.SetBuddyControl(axPageLayoutControl1);

}

2. 生成並執行應用程式。圖形文件被載入到PageLayoutControl，並且TOCControl列出了圖形文件中的資料圖層。使用TOCControl通過複選和取消複選框控制圖層的可見性。預設地，圖形文件的焦點圖(focus map)被裝入MapControl控制元件。在這種當前情況下，ToolbarControl控制元件顯示是空的，因為沒有為它新增任何命令。試著縮放窗體，你會注意到控制元件不會改變尺寸。

(五) 處理視窗縮放

當視窗在執行時進行縮放時，PageLayoutControl和MapControl不會自動改變自身的尺寸。要改變控制元件的尺寸以便它們總是與匹配視窗的範圍，你必須將控制元件錨定在視窗上。如果PageLayoutControl或MapControl包含大量的資料，在視窗縮放期間重繪這些資料顯得相當重要。為了提高執行效率，你可以禁止資料重繪直到縮放操作完成後再重繪之。在縮放時，可以用一個可伸縮的點陣圖來替代重繪資料。

1. 在設計模式顯示窗體並從屬性視窗中選擇axPageLayoutControl1。單擊Anchor屬性，將axPageLayoutControl1錨定在窗體的頂、左、底和右部。

2. 錨定axMapControl控制元件到窗體的頂、左和底部。

3. 在Form_Load事件的開頭增加以下程式碼：

// 當縮放時禁止重繪

this.SetStyle(ControlStyles.EnableNotifyMessage, true);

4. 向類增加以下常量：

public class Form1 : System.Windows.Forms.Form

{

// ……

private const int WM_ENTERSIZEMOVE = 0x231;

private const int WM_EXITSIZEMOVE = 0x232;

// ……

}

5. 向過載的OnNotifyMessage方法中增加下列程式碼：

protected override void OnNotifyMessage(Message m)

{

base.OnNotifyMessage (m);

// 以下為手工新增的程式碼

if ( m.Msg == WM_ENTERSIZEMOVE)

{

axMapControl1.SuppressResizeDrawing(true, 0);

axPageLayoutControl1.SuppressResizeDrawing(true, 0);

}

else if ( m.Msg == WM_EXITSIZEMOVE)

{

axMapControl1.SuppressResizeDrawing(false, 0);

axPageLayoutControl1.SuppressResizeDrawing(false, 0);

}

6. 生成並執行應用程式，試著縮放視窗。

注：禁止縮放時重畫方法是通過檢查傳送到窗體的Windows訊息工作的。當視窗開發縮放時，Windows傳送WM_ENTERSIZEMOVE視窗訊息。此時，我們禁止在MapControl和PageLayoutControl上繪製圖形，而是使用“stretchy bitmap”繪製。當Windows傳送WM_EXITSIZEMOVE訊息時，窗體結束縮放，這時我們全部重繪新的範圍。

(六) 向ToolbarControl增加命令

ArcGIS Engine提供了120多個命令和工具，它們與MapControl、PageLayoutControl和ToolbarControl直接相互協作。這些命令和工具為你提供了大量的經常使用的地圖導航、圖形管理、地物選擇等方面的GIS功能。現在將在你的應用程式中增加這些命令和工具的一部分。

1. 在Form_Load事件中的載入文件程式碼之前新增如下程式碼。

// 增加開啟檔命令

string progID;

progID = "esriControlToolsGeneric.ControlsOpenDocCommand";

axToolbarControl1.AddItem(progID, -1, -1, false, 0,