一個(gè)簡單的編輯功能：插入日期

我創(chuàng)建了一個(gè)簡單插入日期的功能，確切的功能是：在當(dāng)前光標(biāo)的位置或則當(dāng)前選擇文本的地方插入當(dāng)前日期。這是Visual Studio .NET中已經(jīng)包含了一個(gè)用宏實(shí)現(xiàn)此功能的例子。所以你可以看見通過宏和插件兩種不同的方法實(shí)現(xiàn)同樣的功能。這個(gè)例子非常簡單，只需要你修改一個(gè)在前面列出來的那個(gè)Exec函數(shù)。通過前面章節(jié)我已經(jīng)創(chuàng)建了一個(gè)基本插件，這個(gè)插件的名字是“TextUtil”更加確切的說是“TextUtil.Connect.TextUtil”。在Exec函數(shù)中我替換了向?qū)ё詣?dòng)生成的代碼。

handled = true;

替換為

handled = InsertDate();

增加如下InsertData()函數(shù)，可以在Connect對(duì)象中的任何地方增加該函數(shù)。

private bool InsertData()

{

if(applicationObject.ActiveDocument!= null)

((TextSelection)applicationObject.ActiveDocument.Selection).Text

=DateTime.Now.ToString("yyy-MM-dd");

return true;

}

InsertData函數(shù)使用了System.DateTime和Sytem.String對(duì)象。關(guān)于System.String的介紹可以參看幫助。在這里我注意到在OnConnection中關(guān)于CommandBars的三行代碼，這三行代碼是在以后運(yùn)行的過程中要在工具菜單中建立菜單項(xiàng)。

除了名稱插件已經(jīng)完成。按F5來試驗(yàn)插件。一個(gè)新的IDE實(shí)例運(yùn)行，在這個(gè)實(shí)例中這個(gè)插件將出現(xiàn)在工具 外接程序管理對(duì)話框中�？梢酝ㄟ^選中再外接程序管理對(duì)話框中最左面的復(fù)選框來加載插件�，F(xiàn)在你可以打開任何一個(gè)文本文件，然后再Visual Studio .NET的命令窗口中輸入“TextUtil.Command.TextUtil”在當(dāng)前光標(biāo)的位置將插入當(dāng)前日期。事實(shí)上在你完成輸入之前自動(dòng)變異已經(jīng)天填充了命令。

當(dāng)你按下F5開始運(yùn)行一個(gè)IDE新的實(shí)例的時(shí)候，你的插件是在調(diào)試模式下。我們可以在調(diào)試模式下發(fā)現(xiàn)所有異常的信息。在普通的操作中出現(xiàn)了任何的異常，他們都可能不可用。盡可能的得到異常的信息，那么錯(cuò)誤的原因就會(huì)盡早的發(fā)現(xiàn)。

改變命令名稱

向?qū)б呀?jīng)為菜單命令指定了默認(rèn)的名字（TextUtil）。因此這個(gè)名字是不具有特色描述的，我一會(huì)會(huì)增加更多的菜單命令、改變菜單命令名稱。同時(shí)，因?yàn)槲以诟淖兠�令名稱的時(shí)候遇到過名稱混亂的情況，所以我們必須確認(rèn)我們的插件不會(huì)有相同的命令名稱。

第一個(gè)改變是在OnConnection函數(shù)中調(diào)用AddNameCommand之處

Command command = commands.AddNamedCommand(addInInstance,

"InsertDate",

"Insert Current Date",

"Insert Current Date",

true, 59, ref contextGUIDS,

(int)vsCommandStatus.vsCommandStatusSupported

+(int)vsCommandStatus.vsCommandStatusEnabled);



在QuertyStatus中更改如下：

if(commandName.ToLower() == "textutil.connect.insertdate")

向?qū)г诔跏歼\(yùn)行加載之前應(yīng)經(jīng)注冊(cè)了插件信息，但是名稱的改變影響了注冊(cè)信息。這就意味著在增加了插件功能的時(shí)候我們需要從新生成插件項(xiàng)目和安裝項(xiàng)目。然后再運(yùn)行安裝程序。




圖3 運(yùn)行插件（原文：Running the Macro 譯者：可能是錯(cuò)誤）

現(xiàn)在“TextUtil.Connect.InsertDate”命令可以按照我的想法工作了（圖3）。但是，他是怎么工作的呢？讓我們繼續(xù)往下看。