插件是怎么工作的？

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

我將從對象瀏覽器開始（Object Browser）開始，因?yàn)樗�能夠非常容易的讓我們學(xué)習(xí)對象所以他是一非常好的助手。你可以在你要查看的對象上單擊右鍵然后選擇轉(zhuǎn)到定義（Go To Definition）來快事的查看類的成員。最終結(jié)果參看圖4，你可以在列出的成員中查看任何一個成員的原型，或則選擇一個成員按F1訪問在先幫助。




圖4 對象瀏覽器

applicationObject對象描述了插件宿主（host）應(yīng)用程序，在這個例子中宿主（host）應(yīng)用程序?yàn)閂isual Studio .NET IDE。applicationObject在OnConnection方法中實(shí)現(xiàn)。在在線幫助中找到“DTE”，甚至在向?qū)ё詣赢a(chǎn)生的代碼中聲明為“_DTE”類型的變量applicationObject。在應(yīng)用程序級別你會看到她又許多有趣的成員。

其中一個成員是ActiveDocument屬性（property），它描述了當(dāng)前焦點(diǎn)的文檔（document）。這個文檔就是你要進(jìn)行InsertDate操作的文檔。在窗口焦點(diǎn)和文檔焦點(diǎn)有關(guān)系但是不同的情況下，一個非常有用的規(guī)則是，不管窗體是否有焦點(diǎn)具有焦點(diǎn)的文檔都是將要被保存的。

ActiveDocument.Selection屬性返回一個描述當(dāng)前在文檔中選擇的對象。因?yàn)樵贑#中它是一個普通對象，所以我他它強(qiáng)制類型轉(zhuǎn)換成TextSelectioni。ActiveDocument是一個普通的類，因?yàn)閐ocument（譯者：類似于VC++中的document類）沒有必要基于text，就好比一個窗體設(shè)計(jì)document（譯者：學(xué)過VC++的人可能比較熟悉document類的繼承關(guān)系，不熟悉的人可以看看有關(guān)這方面的書籍）。作為最終結(jié)果Selection屬性也是一個普通的類，在這里我把它強(qiáng)制類型轉(zhuǎn)換成類我們在代碼中實(shí)際操作的TextSelection類型。

TextSelection描述了一個文件的視圖（view），并且這個文件的動作和工具 選項(xiàng)中的設(shè)置還有使用的狀態(tài)一至。他提供了很多的你可能想到用于修改文件的屬性和方法，還有他可以影響使用的視圖（view），當(dāng)前選擇的內(nèi)容，插入位置。如果你曾經(jīng)錄制過宏，你可以看見使用TextSelection對象來捕獲內(nèi)容。

InsertDate簡單的的設(shè)置了Text屬性值是當(dāng)前的日期。類似Text一樣，所有的動作都可以設(shè)置同類型的值。這就意味著所有得到的內(nèi)容都要被替換，如果沒有選擇內(nèi)容那么就會在光標(biāo)的位置上替換，不過你要注意當(dāng)前的狀態(tài)是插入還是覆蓋模式。

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

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

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

(int)EnvDTE.vsInsertFlags.vsInsertFlagsCollapseToEnd);

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

現(xiàn)在你因該理解了插件是怎么工作的了，讓我們?yōu)檫@個命令簡單的作一個鍵盤邦定和增加一個菜單。

圖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.