PIE.NET-SDK插件式二次開發文檔


 

一 PIE.Net開發環境部署

1.     開發環境部署
  • 確保Win7系統已安裝SP1
  • 安裝Visual Studio2013(支持VS2010/2012/2013/2015)
  • 安裝PIESDK.exe二次開發包的A版本
2.【SDK】安裝后目錄說明

 

1)        Bin>>開發包

2)        Config>>配置文件

3)        Data>>坐標系投影及數據映射表

4)        Document>幫助文件

5)        Language>>語言國際化

6)        Res>>按鈕圖標及鼠標Cursor樣式

7)        Sample>>實例文件

8)        Style>>符號庫文件

9)        Template>>制圖模板

檢驗PIEApplication.exe是否可用!

二 PIE.Net-SDK插件式開發步驟

1.     新建工程
1.1     新建項目

 

2-1:新建項目

 

2-2: 新建項目

    注意項目框架選擇.NET Framework 4,按上圖紅色框選擇新建項目。

2.   項目屬性配置,保持與SDK開發包一致
2.1    程序應用平台配置

2-3: 配置管理器

點擊下拉箭頭選擇配置管理器按鈕。

 

2-4: 配置管理器

2-5: 配置管理器

    按如圖2-4、圖2-5所示,分別配置debug/release的活動解決方案平台為x86

2.2      應用程序目標框架及生成路徑配置

2-6: 項目屬性

 

2-7: 配置目標框架

    如圖2-6、2-7所示,右鍵打開項目屬性,在【應用程序】選項卡中確定目標框架.Net Framework4,輸出類型為類庫

 

2-8: 配置輸出路徑

3.     功能實現
3.1      添加項目引用

2-9: 添加引用

    展開項目目錄樹,右鍵點擊【引用】選擇【添加引用】菜單項。

    在彈出的引用管理器中 點擊【程序集】的【擴展】項下拉選擇。

 

 

2-10: 添加引用

    瀏覽添加上圖紅色框選中的類庫,單擊確定即可。

    注意:引用項可以根據自己開發的插件功能需求進行選擇。

3.2      以加載矢量數據為例新建Command命令

2-11: 新建類

2-12: 新建加載矢量命令

2-13: 代碼實現

    通過重載OnCreate和OnClick,實現命令對象的創建,和事件里具體內容的實現。

    注意:Tool(工具插件):適用於與地圖或制圖組件有交互的插件,只需繼承自BaseTool(繼承自BaseCommand),根據功能需要可重寫OnMouseDown、OnMouseMove等方法,如:拉框放大、探針、畫多邊形等。

    Command(命令插件):與地圖無交互,只需繼承自BaseCommand,重寫OnClick方法,如:全圖、居中放大、前一視圖等。彈出窗體的Command繼承至DesktopCommand,如空間量測工具,而這里的加載矢量數據Command繼承至BaseCommand。

2-14:初始化 

在構造函數里初始化 界面按鈕的樣式:

m_Image為按鈕背景圖片;

注意:主程序首先通過配置文件查找圖片,若配置文件中的圖片不存在則使用工程中定義的圖片。

Caption 為按鈕名稱;

Name 為命令對象的名稱;

ToolTip 為按鈕提示內容;

Checked 表示初始化時按鈕是否為選中狀態;

Enabled 設置初始化時按鈕的可用性

 

2-15:創建插件對象

     通過OnCreate方法傳遞hook對象,也就是MapControl對象,賦值給Command對象的m_Hook和m_HookHelper

2-16:實現加載矢量數據方法

    通過以上步驟,矢量數據加載命令即創建完畢。 

3.3   在主程序中調用插件

3.3.1  設置啟動宿主程序PIEApplication.exe

    右鍵項目在調試選項中,選擇啟動外部程序,路徑為安裝路徑目錄下\Bin\PIEApplication.exe

 

2-17: 啟動宿主程序PIEApplication.exe

3.3.2   配置文件設置

2-18:修改配置文件

在配置文件中新增Item項,設置控件類型(Type)為button,

library為插件類名,即PIE.ControlsTest.dll(帶后綴的全稱)

caption為控件在界面顯示的名稱

identity為唯一標識,格式為類庫名稱+命令對象名稱,即PIE.ControlsTest.VectorCommand代碼中通過identity找到對應命令控件

Image 為插件的背景圖片名稱,圖片放置位置為安裝路徑目錄下的【Res】文件夾下

2-19:插件控件背景圖片設置

    其中標簽項page、group、item對應界面上的控件如下所示

 

2-20:界面與配置文件對應關系

3.3.3  效果展示

 

 

2-21:效果展示

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM