Add-In即模塊加載項，是一種能夠快速擴(kuò)展桌面應(yīng)用程序功能的全新擴(kuò)展方式。

---

一、創(chuàng)建新項目

1、打開VS2002，選擇創(chuàng)建新項目。

2、在搜索框中輸入“arcgis pro”，在搜索結(jié)果中選擇【ArcGIS Pro 模塊加載項】創(chuàng)建項目，注意選擇語言應(yīng)該是C#，而不是VB。

3、點(diǎn)擊下一步，填寫項目名稱、位置和解決方案名稱，可隨意，點(diǎn)擊創(chuàng)建。

生成的主界面如下：

---

二、添加一個按鈕，并重寫OnClick方法

1、在資源管理器中右鍵點(diǎn)擊項目，選擇【添加】—【新建項】。

2、在添加新項選項框中，左側(cè)選擇【ArcGIS】，主選框中選擇【ArcGIS Pro 按鈕】，點(diǎn)擊添加。

生成按鈕后，資源管理器里會新生成一個【Button1.cs】。

【Config.daml】文件里也會自動新增一段</button>代碼：

<button id="ProAppModule1_Button1" caption="Button 1" className="Button1" loadOnClick="true" smallImage="pack://application:,,,/ArcGIS.Desktop.Resources;component/Images/GenericButtonBlue16.png" largeImage="pack://application:,,,/ArcGIS.Desktop.Resources;component/Images/GenericButtonBlue32.png">
<tooltip heading="Tooltip Heading">Tooltip text<disabledText /></tooltip>
</button>

</group>中也會新增一行：

<button refID="ProAppModule1_Button1" size="large" />

代碼運(yùn)行的結(jié)果：當(dāng)Pro加載時，會在“菜單欄-加載項-Group 1”中顯示新增的按鈕。這部分暫時先不修改。

3、雙擊新生成的【Button1.cs】，在OnClick()中輸入：

MessageBox.Show("Hello World");

老慣例了……

三、調(diào)試

1、點(diǎn)擊菜單【生成】—【生成解決方案】。

2、點(diǎn)擊工具欄的【調(diào)試】按鈕。系統(tǒng)會自動打開ArcGIS Pro。

3、點(diǎn)擊打開的ArcGIS Pro的選項卡【加載項】，可以看到下面有一個新的組，組里有一個按鈕，這就是我們剛剛新建的按鈕。

4、點(diǎn)擊按鈕，彈出消息框，運(yùn)行成功。

四、修改新增按鈕的布局和屬性

主要就是修改【Config.daml】文件的代碼。修改后的局部代碼如下：

<modules><insertModule id="ProAppModule1_Module" className="Module1" autoLoad="false" caption="Module1"><!-- uncomment to have the control hosted on a separate tab--><tabs><tab id="ProAppModule1_Tab1" caption="新的選項卡"><group refID="ProAppModule1_Group1"/></tab></tabs><groups><!-- comment this out if you have no controls on the Addin tab to avoidan empty group--><group id="ProAppModule1_Group1" caption="新的組" appearsOnAddInTab="false"><!-- host controls within groups --><button refID="ProAppModule1_Button1" size="large" /></group></groups><controls><!-- add your controls here --><button id="ProAppModule1_Button1" caption="新的按鈕" className="Button1" loadOnClick="true" smallImage="Images/BexDog16.png" largeImage="Images/BexDog32.png"><tooltip heading="提示">這是提示信息<disabledText /></tooltip></button></controls></insertModule></modules>

修改后調(diào)試結(jié)果如下：

具體修改內(nèi)容如下：

（1）新增了一個</tab>，內(nèi)部引用了一個<group refID="ProAppModule1_Group1"/>。注意refID和下面group的ID要一致。

（2）caption即為各個控件在界面顯示的標(biāo)簽。

（3）<group/>下的appearsOnAddInTab默認(rèn)為true，即會添加到默認(rèn)的【加載項】選項卡下，如果你新建了選項卡，建議改為【false】。

（4）</tooltip>即為提示信息。

（5）</button>下的【smallImage】和【largeImage】是按鈕在界面上顯示的圖標(biāo)。這里我更改了圖標(biāo)。首先需要在資源管理器中加入自己的圖片，圖片格式和大小建議參考系統(tǒng)自帶的那2個。然后選擇新添加的圖片，在右側(cè)屬性欄中更改【生成操作】為【內(nèi)容】。最后在代碼里把路徑修改好，見上面的代碼。

如此，便修改完成。

五、生成Add-In插件

1、如果是第一次生成，點(diǎn)擊菜單【生成】—【生成選定內(nèi)容】。如果不是第一次，可以點(diǎn)擊【重新生成選定內(nèi)容】。待下方消息欄出現(xiàn)如下信息即為生成成功。

2、找到項目目錄【bin\Debug\net6.0-windows】下的【.esriAddinX】文件，雙擊，即可安裝到ArcGIS Pro上。

3、 打開ArcGIS Pro。結(jié)果和調(diào)試時的一致，即為安裝成功。

4、點(diǎn)擊【工程】—【加載項管理器】，即可看到剛剛安裝的工具，如果想移除掉，可以點(diǎn)擊右下方的【刪除此加載項】。

至此，我們的第一個Add-in項目就算完成了。雖然很簡陋。。