在Visual Studio.NET中使用自訂外掛程式最大化您的生產力(三)

visual|最大化 外掛程式是怎麼工作的？

在前面章節中給你們示範的InsertDate代碼是相當簡單的，而且自動完成功能讓人感覺不可思議。

我將從物件瀏覽器開始（Object Browser）開始，因為他能夠非常容易的讓我們學習對象所以他是一非常好的助手。你可以在你要查看的對象上單擊右鍵然後選擇轉到定義（Go To Definition）來快事的查看類的成員。最終結果參看圖4，你可以在列出的成員中查看任何一個成員的原型，或則選擇一個成員按F1訪問在先協助。




圖4 物件瀏覽器

applicationObject對象描述了外掛程式宿主（host）應用程式，在這個例子中宿主（host）應用程式為Visual Studio .NET IDE。applicationObject在OnConnection方法中實現。在線上協助中找到“DTE”，甚至在嚮導自動產生的代碼中聲明為“_DTE”類型的變數applicationObject。在應用程式層級你會看到她又許多有趣的成員。

其中一個成員是ActiveDocument屬性（property），它描述了當前焦點的文檔（document）。這個文檔就是你要進行InsertDate操作的文檔。在視窗焦點和文檔焦點有關係但是不同的情況下，一個非常有用的規則是，不管表單是否有焦點具有焦點的文檔都是將要被儲存的。

ActiveDocument.Selection屬性返回一個描述當前在文檔中選擇的對象。因為在C#中它是一個普通對象，所以我他它強制類型轉換成TextSelectioni。ActiveDocument是一個普通的類，因為document（譯者：類似於VC++中的document類）沒有必要基於text，就好比一個表單設計document（譯者：學過VC++的人可能比較熟悉document類的繼承關係，不熟悉的人可以看看有關這方面的書籍）。作為最終結果Selection屬性也是一個普通的類，在這裡我把它強制類型轉換成類我們在代碼中實際操作的TextSelection類型。

TextSelection描述了一個檔案的視圖（view），並且這個檔案的動作和工具|選項中的設定還有使用的狀態一至。他提供了很多的你可能想到用於修改檔案的屬性和方法，還有他可以影響使用的視圖（view），當前選擇的內容，插入位置。如果你曾經錄製過宏，你可以看見使用TextSelection對象來捕獲內容。

InsertDate簡單的的設定了Text屬性值是當前的日期。類似Text一樣，所有的動作都可以設定同類型的值。這就意味著所有得到的內容都要被替換，如果沒有選擇內容那麼就會在游標的位置上替換，不過你要注意當前的狀態是插入還是覆蓋模式。

另外一種方法是使用Insert函數，這個方法允許你控制文本放置的位置和描述了一個不能重做的動作。使用這個方法來替換Text屬性指定插入內容的代碼如下：

((TextSelection)applicationObject.ActiveDocument.Selection).Insert(

DateTime.Now.ToString("yyyy-MM-dd"),

(int)EnvDTE.vsInsertFlags.vsInsertFlagsCollapseToEnd);

這個vsInsertFlags指出了文本已什麼方式什麼位置插入的。線上幫組中忽略了vsInsertFlags的文檔，所以我在圖5中包含了這部分。

現在你因該理解了外掛程式是怎麼工作的了，讓我們為這個命令簡單的作一個鍵盤邦定和增加一個菜單。

圖5 vsInsertFlags 值

vsInsertFlagsCollapseToEnd
The selection's current

contents are deleted before

performing the insertion, and

the TextSelection is left empty

at the end of the newly

inserted text.




vsInsertFlagsCollapseToStart


The selection's current

contents are deleted before

performing the insertion, and

the TextSelection is left empty

at the beginning of the newly

inserted text.




vsInsertFlagsContainNewText


The selection's current

contents are replaced with the

inserted text, and the

TextSelection is left containing

the new text.




vsInsertFlagsInsertAtStart
The inserted text is placed at

the beginning of the

TextSelection, and the

resulting TextSelection

contains both the new and

previous text.




vsInsertFlagsInsertAtEnd


The inserted text is placed at

the end of the TextSelection,

and the resulting

TextSelection contains both

the new and previous text.