手把手教你制作vs2005装饰

如果把.net开发人员比作是行走江湖的侠客,那vs就好比是侠客手中的剑,比武的时候讲究的的一寸长,一寸强,那我们应该如何改善我们的武器呢?铁匠铺的铁匠老软早就为我们做好了准备,他在我们的武器上装了很多环,打了很多洞,我们完全可以在这些环或洞上镶嵌珠宝,让这把剑更加靓丽,也可以在这把剑上装上暗器,增加武器杀伤力,如果您自身还练就了九阳神功,配上这把倚天剑,包你很快就知道无敌真寂寞的滋味。哈哈。不胡诌了,言归正传,本文通过详细的操作步骤讲述一个装饰vs2005的故事。
让我们打开vs2005,选择创建项目,在接下来的向导中选择项目模板:其他项目类型-扩展性-visual studio外接程序,然后给我们的大钻石起个漂亮的名字:RecentProjectCleaner。忘记说了,这个外接程序要完成的任务是在菜单的工具栏创建一个子菜单,点击这个子菜单可以呼出我们的暗器,这个暗器用来清除vs2005起始页中的最近项目列表、 第一个步骤的图示如下:

然后,一路next,直到出现选择外接程序选项对话框的时候,选择如下:

点击下一步,完成向导后,项目模板会自动生成的文件列表如下:
CommandBar.resx ----------- 这个是命令栏的资源文件
Connect.cs ----------- 是一个继承了IDTExtensibility2, IDTCommandTarget的类,是addins的实现类
RecentProjectCleaner.AddIn -------------------这个是addins进行xcopy部署的配置文件,部署的时候拷贝到C:\Documents and Settings\Administrator\My Documents\Visual Studio 2005\Addins
RecentProjectCleaner - For Testing.AddIn -------------这个是调试运行的的测试类,在调试的时候,这个文件会自动拷贝到C:\Documents and Settings\Administrator\My Documents\Visual Studio 2005\Addins位置
首先介绍最主要的文件Connect.cs ,这个类包含如下的实现方法
OnConnection - 处理外接程序加载的时候触发
OnDisconnection - 在处理外接程序卸载的时候触发
OnAddInsUpdate - 外接程序出现更新的时候触发
OnStartupComplete - 外接程序加载结束时候触发
OnBeginShutdown - 开始卸载的时候触发
QueryStatus - 查询状态
Exec - 执行命令
本例中,我们实现的目的是:在工具菜单上创建一个新的子菜单,点击这个菜单,能够清除启动页最近项目列表,所以我们需要做的是
1) 在外接程序加载的时候,创建菜单
2) 点击菜单,执行删除最近列表项的命令
3) 卸载的时候,删除新增菜单项
所以添加工具子菜单的代码要添加到OnConnection 中如下:

1 /**//// <summary>实现 IDTExtensibility2 接口的 OnConnection 方法。接收正在加载外接程序的通知。</summary>
2 /// <param term='application'>宿主应用程序的根对象。</param>
3 /// <param term='connectMode'>描述外接程序的加载方式。</param>
4 /// <param term='addInInst'>表示此外接程序的对象。</param>
5 /// <seealso class='IDTExtensibility2' />
6 public void OnConnection(object application, ext_ConnectMode connectMode, object addInInst, ref Array custom)
7 {
8 _applicationObject = (DTE2)application;
9 _addInInstance = (AddIn)addInInst;
10 if (connectMode == ext_ConnectMode.ext_cm_UISetup)
11 {
12 object[] contextGUIDS = new object[] { };
13 Commands2 commands = (Commands2)_applicationObject.Commands;
14 string toolsMenuName = "工具";
15
16 //将此命令置于“工具”菜单上。
17 //查找 MenuBar 命令栏,该命令栏是容纳所有主菜单项的顶级命令栏:
18 Microsoft.VisualStudio.CommandBars.CommandBar menuBarCommandBar = ((Microsoft.VisualStudio.CommandBars.CommandBars)_applicationObject.CommandBars)["MenuBar"];
19
20 //在 MenuBar 命令栏上查找“工具”命令栏:
21 CommandBarControl toolsControl = menuBarCommandBar.Controls[toolsMenuName];
22
23
24 CommandBarPopup toolsPopup = (CommandBarPopup)toolsControl;
25
26 //如果希望添加多个由您的外接程序处理的命令,可以重复此 try/catch 块,
27 // 只需确保更新 QueryStatus/Exec 方法,使其包含新的命令名。
28 try
29 {
30 //将一个命令添加到 Commands 集合:
31 Command command = commands.AddNamedCommand2(_addInInstance, "RecentProjectCleaner", "RecentProjectCleaner", "Executes the command for RecentProjectCleaner", true, 59, ref contextGUIDS, (int)vsCommandStatus.vsCommandStatusSupported + (int)vsCommandStatus.vsCommandStatusEnabled, (int)vsCommandStyle.vsCommandStylePictAndText, vsCommandControlType.vsCommandControlTypeButton);
32
33 //将对应于该命令的控件添加到“工具”菜单:
34 if ((command != null) && (toolsPopup != null))
35 {
36 command.AddControl(toolsPopup.CommandBar, 10);
37 }
38 }
39 catch (System.ArgumentException)
40 {
41 //如果出现此异常,原因很可能是由于具有该名称的命令
42 // 已存在。如果确实如此,则无需重新创建此命令,并且
43 // 可以放心忽略此异常。
44 }
45 }
46 }

执行命令的操作添加到Exec中,

Exec
/**//// <summary>实现 IDTCommandTarget 接口的 Exec 方法。此方法在调用该命令时调用。</summary>
/// <param term='commandName'>要执行的命令的名称。</param>
/// <param term='executeOption'>描述该命令应如何运行。</param>
/// <param term='varIn'>从调用方传递到命令处理程序的参数。</param>
/// <param term='varOut'>从命令处理程序传递到调用方的参数。</param>
/// <param term='handled'>通知调用方此命令是否已被处理。</param>
/// <seealso class='Exec' />
public void Exec(string commandName, vsCommandExecOption executeOption, ref object varIn, ref object varOut, ref bool handled)
{
handled = false;
if (executeOption == vsCommandExecOption.vsCommandExecOptionDoDefault)
{
if (commandName == "RecentProjectCleaner.Connect.RecentProjectCleaner")
{
DialogResult dr = MessageBox.Show("确定要清除最近项目列表么?", "询问", MessageBoxButtons.YesNo);
if (dr == DialogResult.Yes)
{
Microsoft.Win32.RegistryKey regisKey = Microsoft.Win32.Registry.CurrentUser;
Microsoft.Win32.RegistryKey key = regisKey.OpenSubKey("Software", true);
if (key != null)
{
key = key.OpenSubKey("Microsoft", true);
if (key != null)
{
key = key.OpenSubKey("VisualStudio", true);
}
if (key != null)
{
key = key.OpenSubKey("8.0", true);
}
if (key != null)
{
key = key.OpenSubKey("ProjectMRUList", true);
}
if (key != null)
{
foreach (string p in key.GetValueNames())
{
key.DeleteValue(p, false);
}
}
MessageBox.Show("清除成功,重新启动vs后生效!");
}
}
handled = true;
return;
}
}
}

在程序卸载的时候,卸载菜单项


1 /**//// <summary>实现 IDTExtensibility2 接口的 OnDisconnection 方法。接收正在卸载外接程序的通知。</summary>
2 /// <param term='disconnectMode'>描述外接程序的卸载方式。</param>
3 /// <param term='custom'>特定于宿主应用程序的参数数组。</param>
4 /// <seealso class='IDTExtensibility2' />
5 public void OnDisconnection(ext_DisconnectMode disconnectMode, ref Array custom)
6 {
7 object[] contextGUIDS = new object[] { };
8 Commands2 commands = (Commands2)_applicationObject.Commands;
9 string toolsMenuName= "工具";
10 //将此命令置于“工具”菜单上。
11 //查找 MenuBar 命令栏,该命令栏是容纳所有主菜单项的顶级命令栏:
12 Microsoft.VisualStudio.CommandBars.CommandBar menuBarCommandBar = ((Microsoft.VisualStudio.CommandBars.CommandBars)_applicationObject.CommandBars)["MenuBar"];
13
14 //在 MenuBar 命令栏上查找“工具”命令栏:
15 CommandBarControl toolsControl = menuBarCommandBar.Controls[toolsMenuName];
16
17
18 CommandBarPopup toolsPopup = (CommandBarPopup)toolsControl;
19
20 //如果希望添加多个由您的外接程序处理的命令,可以重复此 try/catch 块,
21 // 只需确保更新 QueryStatus/Exec 方法,使其包含新的命令名。
22 try
23 {
24 //将一个命令添加到 Commands 集合:
25 Command command = commands.AddNamedCommand2(_addInInstance, "RecentProjectCleaner", "RecentProjectCleaner", "Executes the command for RecentProjectCleaner", true, 59, ref contextGUIDS, (int)vsCommandStatus.vsCommandStatusSupported + (int)vsCommandStatus.vsCommandStatusEnabled, (int)vsCommandStyle.vsCommandStylePictAndText, vsCommandControlType.vsCommandControlTypeButton);
26
27 //将对应于该命令的控件添加到“工具”菜单:
28 if ((command != null) && (toolsPopup != null))
29 {
30 command.Delete();
31 }
32 }
33 catch (System.ArgumentException)
34 {
35 //如果出现此异常,原因很可能是由于具有该名称的命令
36 // 已存在。如果确实如此,则无需重新创建此命令,并且
37 // 可以放心忽略此异常。
38 }
39 }

这样一个非常简单的vs2005addins就制作成功了,接下来您就可以将该程序部署到你的倚天剑上了,部署方法超级简单,和vs03不同的是,05支持xcopy部署,您可以将RecentProjectCleaner.AddIn和生成的RecentProjectCleaner.dll拷贝到C:\Documents and Settings\Administrator\My Documents\Visual Studio 2005\Addins,就完成了addins的部署,值得说下的是RecentProjectCleaner.AddIn,这个文件描述了vs2005应该如何认识新增的伙计,它里面定义了宿主应用程序的信息(名称,版本)和addins的信息(所在程序集,类名,加载方式),如果您想在部署后让addins立即被启用,将LoadBehavior设置为1,还有不知道是我本地项目模板的问题还是其他原因,默认创建的RecentProjectCleaner.AddIn里面的Assembly多了.dll。也就是RecentProjectCleaner.dll,这样的dll显然不存在,去掉一个.dll,就可以了
看下部署后的效果吧:重新启动vs2005,点击工具,菜单就多了一项:RecentProjectCleaner,如图

点击外接程序管理器,可以多了一项RecentProjectCleaner
在菜单中点击RecentProjectCleaner,选择清除,重启vs2005,最近列表项就清除了。

这里是源程序,这里只是一个的介绍,大家可以下载下去扩展,很好玩
/Files/jillzhang/RecentProjectCleaner.rar

来源:jillzhang的专栏

posted on 2007-10-03 22:59  小啤酒  阅读(173)  评论(0编辑  收藏

导航