Visual C++ 6 Add-in編程執行個體

作者:hao.yu

下載本文範例程式碼

最近我用了一些時間來學習如何編寫用於Visual C++ 6.0的Add-In。這是一個有趣的問題，不過總的來說，有關這方面的文檔和範例程式仍然比較缺乏（中文的更加罕見）。因此我決定把自己學習過程中的一些心得寫出來，和大家共用。

一、有關Visual C++ Add-In的常見問題

（1）什麼是Visual C++ Add-In？它有什麼用途？

總的來說，Visual C++ Add-In就是實現某些特定COM介面的組件對象，它可以嵌入Developer Studio整合式開發環境中，並提供一些命令用於實現自動化任務，或者簡化程式編寫過程等等。

從程式員的角度來講，一個Visual C++ Add-In基本上就是實現了IDSAddIn介面的COM對象。通過這個介面，Add-in能夠掌管Developer Studio環境，並且執行特定的任務。

（2）如何編寫Add-In？

最簡單的辦法是啟動Visual C++ AppWizard，並且從項目類型中選擇DevStudio Add-in Wizard，如。

（3）到哪裡去找有關Add-In的編程資料和文檔？

最完整的文檔在MSDN中，位置是MSDN Library/Visual Studio Documentation/Using Visual C++/Visual C++ User''s Guide/Automating Tasks in Visual C++/Add-ins for Visual C++ Developer Studio。不同版本的MSDN可能在具體路徑上有一些小差別。

（4）如何使用Add-In？

如果你獲得了一個有用的Add-in，或者自己編寫了一個，請按照如下的步驟安裝它：

從Visual C++的主菜單中選擇Tools | Customize，然後翻到Add-ins and Macro Files頁面：

如果你的Add-in沒有出現在列表中，則按Browse按鈕，找到Add-in檔案（注意要將預設的檔案類型(*.dsm)改成(*.dll)）：

稍候，Add-in將會出現在Add-ins and Macros列表中。確認Add-in左邊的檢查框處於選中狀態，然後按Close。

回到Integration Environment，一般來說Add-in會在環境中增加一個新工具列，上面列出這個Add-in可用的命令。現在你可以用這些命令按鈕工作了。

（5）Add-in有什麼優缺點？

Add-in是和開發環境整合在一起的，這意味著我們不用離開IDE就能利用Add-in完成工作，而不需要藉助外部工具，這是Add-in的一大優點。因此，Add-in通常用來簡化一些重複性的工作，提高程式員的工作效率。例如，某個名為AutoBuildNumber的Add-in可以在每次編譯工程的時候自動將版本號碼加1；另外一個名為WndTabs的著名的Add-in（估計讀者中部分人已經在使用它了）則提供了一個類似於Ultra-Edit的頁面，讓程式員可以快速在開啟的檔案中切換。

Add-in也有它的缺點，這表現在幾方面。首先，如果你的目的是簡化重複性的工作，並不一定非要編寫Add-in不可：你可以首先考慮編寫宏指令碼（Macro Script）。指令碼和Add-in一樣具有訪問完整的Developer Studio Object Model的能力，而且它的編寫和維護更簡單，所以也是個不錯的選擇。但是，指令碼無法實現比較進階的功能，例如調用Win32 API等等；這時候你就該考慮Add-in了。

Add-In的另外一個缺點是它受限制於開發環境提供的介面。微軟為Add-In提供了一組介面，你需要使用這些介面的屬性和方法來完成實際的任務，如果某些特性是介面所不提供的，那麼你也很難在Add-in中實現它們。要瞭解Add-in能做些什麼和不能做什麼，最好的辦法就是熟悉Developer Studio物件模型，為此請參考MSDN。此外，Add-in無法（或很難）實現進階UI功能，比如Add-in所能實現的使用者介面基本上就只有模態對話方塊而已；如果想自己建立一個視窗並且和IDE聯絡在一起，幾乎是不可能的。像WndTabs這樣的Add-in實現了一些特殊的技巧來突破這個限制，但它多多少少利用了一些Hacker手段，這並不為官方所支援，也就是說只要微軟對Visual C++作一點小小的改動，它就可能完全失效；另外要自己摸索出這些技巧也是非常困難的，所以一般來講並不推薦這種做法。

 

二、本文的例子程式

現在轉入正題，介紹一下我根據Add-in文檔資料作的一個具體例子。這個例子實現了四個有用的方法，下面我將一一介紹。

（1）Show Object Model

這個方法是學習文檔的產物，因為我在閱讀MSDN的時候，總想瞭解Add-in規範所提供的物件模型具體應該是什麼樣子的。於是有了這個方法，當你選擇此項命令的時候，它會調出一個對話方塊，其中按照層次關係列出模型中的所有對象，以及它們各自具有的屬性。

你可以看到，模型最頂層是一個Application對象，它的名字為Microsoft Developer Studio，版本為6.0，其他屬性也可以很直觀的查看。關於這些具體對象和他們之間的關係，請參考MSDN。

在實際編寫Add-in的時候我發現這個方法也是非常有用的，因為它能夠直觀的告訴我：當前有哪些對象，以及對象的那些屬性是可用的。這樣我就節省了不少時間來在Visual C++和MSDN之間反覆切換。

（2）Switch Between .H and .CPP

用過Borland C++ Builder的朋友應該很熟悉這個方法，比如當前開啟了Test.cpp，用這個命令就能立刻查看對應的Test.h，反之亦然。Visual C++並沒有實作類別似的功能，所以我寫了個方法來類比C++ Builder。

（3）Open RC As Text

有時候我們需要開啟工程的資源檔作一些文字上的編輯，在某些情況下這比用Resource Editor更方便快捷，也可以避開Integration Environment的限制。可是Visual C++中並沒有簡單的方法可以做到這一點，於是每次我都不得不關閉所有資源視窗、用Open命令瀏覽到RC檔案、選擇開啟檔案為Text，經過好幾個步驟才能完成，為什麼不自動化一點呢？Open RC As Text命令就是實現這個功能的。

（4）Include Browser

這個命令可以快速開啟列在Visual C++ Include環境變數中的標頭檔，避免了手工尋找的麻煩。它有一個很貼心的功能，當列出的檔案太多時，輸入你想要看的檔案頭幾個字元，列表會自動過濾出合格檔案，不需要在長長的列表中前後翻動。例如我想查看一下和Windows Socket相關的標頭檔定義，只要選擇這個命令並輸入“winsock”，於是列表中會列出合格檔案，選擇檔案並按“Open”即可開啟它，如所示。

關於程式碼並沒有很特殊的地方，所以我也不打算講解它們，如果你有不明白的地方，參考原始碼即可。即便如此，代碼仍然提供了一些有趣的東西，例如簡化查詢介面屬性和方法的模板函數、CComDispatchDriver對象的使用、在對話方塊中嵌入工具列、定製繪畫（Custom Draw）的列表控制、註冊表查詢函數等，它們中許多方法都是可重用或可借鑒的。具體內容請查閱相關的代碼。

三、關於程式的說明和結論

因為這個程式目前還只是草稿，如果你對Add-in編程感興趣的話，那麼它提供了一個良好的起點；即使你不願意自己編寫的話，上面列出的幾項功能也可能對你的日常編程任務有所協助。Add-in編程是一個有趣的領域，在這裡你可以和每日相伴自己的整合式開發環境同呼吸共命運，並且在Visual Studio.Net 2002和Visual Studio.Net 2003中這個模型還在不斷變化和增強。本文的例子是以Visual C++ 6.0完成的，但是在後續的版本中仍有參考價值。如果你想進一步瞭解關於Add-in的更多資料，請參考MSDN Online、CodeGuru和CodeProject等幾個著名的Visual C++編程網站，相信你一定能夠提高自己編寫Add-in的能力。