首页 > 代码库 > VS2013点击右键菜单命令添加xml元素插件开发

VS2013点击右键菜单命令添加xml元素插件开发

一、选择Visual Studio Package模板建立插件项目

由于此功能需要在右键菜单上添加命令,所以选择Visual Studio Package模板,根据模板向导步骤插件项目,在Select VSPackage Options步骤的时候选择Menu Command选项,如图-1所示:

图-1

接下来是设置命令的名称,如图-2所示

图-2

修改Command name的值,将其设置为我们要添加到右键菜单时的名称。Command ID可选择是否修改,值是一个十六进制数,由于标识我们的添加的命令。按照模板向导建立好插件项目后,按F5运行插件项目,此时VS会新建一个实验实例,点击工具菜单,可以看到已经有一个命令添加到工具菜单里了,如名称My Command name(如果没有修改Command name的值得话)如图-3所示:

图-3

点击该命令的时候会弹出一个提示框。现在有两个疑问:

1、命令是如何与具体的功能关联?

2、该命令是如何添加到工具菜单?

对于第一个疑问:我们可以打开项目下以Package结尾的cs文件,该文件里有一个Initialize方法和一个MenuItemCallback事件处理方法,Package代码文件只有在我们点击命令的时候才会被

加载运行。当我们点击命令的时候会依次调用构造函数、Initialize方法、MenuItemCallBack事件处理方法,MenuItemCallBack事件处理方法就是在Initialize方法里与我们的命令进行关联。

对于第二个疑问:在项目的文件里我们可以找到一个以vsct(Visual Studio Command Table)为后缀的文件,命令就是通过该文件添加到工具菜单下的,项目在编译的时候会将该文件编译为二进制文件。

二、vsct文件简介

在vsct文件里,我们的菜单命令使用Button元素来表示的,如图-3所示:

图-4

在图-3可以看到Button有一个子元素Parent,该子元素表示要将我们的命令添加到那个菜单下面,如工具、帮助、右键菜单,id属性的值是在Group元素的id属性值,如图-4所示:

图-5

Group元素定义了目标菜单的guid和id,也可以将图-4的guid和id换成guidSHLMainMenu和IDM_VS_MENU_TOOLS,这两种效果是一样的,都是将命令添加到右键菜单里。如果要按照图-4的方式设置guid和id值的话,需要事先知道目标菜单的guid和id值,并且要在Sysmbols元素里定义guid和id,如图-5所示:

图-6

除了红色框里的元素是我们自己定义的,其他的都是向导自动生成。那么为什么使用guidSHLMainMenu和IDM_VS_MENU_TOOLS作为guid和id两个属性的值的时候就需要在Sysmbols元素里定义了呢?因为这两个元素的值已经在stdidcmd.h和vsshlids.h(C:\Program Files (x86)\Microsoft Visual Studio 12.0\VSSDK\VisualStudioIntegration\Common\Inc)这两个文件里定义了,而这两个文件已经在vsct文件的开头就已经使用Extern元素引入了,所以就不需要我们再去定义了。

三、如何获取目标菜单的guid和id值

1、打开注册表编辑器(打开运行窗口,输入regedit),在[HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\12.0\General]找到该路径,右击-新建-DWORD(32-位)值(D),建立一个注册文件,将其命名为EnableVSIPLogging,并将其值改为1。按下Ctrl+Shift,用鼠标点击VS里的菜单,就会弹出一个VSDebug Message窗口,如图-6所示:

图-7

其中Guid和CmdID值就是我们需要的,NameLoc表示我们点击的菜单名称。

四、设置命令只在xml文件的右键菜单里显示

由于命令关联的操作都是在点击命令的时候才调用的,所以要实现此功能需要四个步骤才能实现:

1、在Button元素加入子元素<CommandFlag>DynamicVisibility</CommandFlag>

2、为Package类加入特性ProvideAutoLoad,该特性表示当满足条件的时候,事先加载该类里的相关运行。而条件是由该特性的构造函数来设置的,相关的条件已经定义为UIContextGuids80抽象类的常量字段了。

3、将Initialize方法里的MenuCommand类改为OleMenuCommand类,并订阅OleMenuCommand类实例的BeforeQueryStatus事件,如图-8所示:

图-8

4、在BeforeQueryStatus事件处理函数里显示控制操作,如控制命令只在xml文件的右键菜单里才能显示,代码如下所示:

 1 private void menuItem_BeforeQueryStatus(object sender, EventArgs e) 2 { 3     OleMenuCommand menuCommand = sender as OleMenuCommand; 4     if (menuCommand != null) 5     { 6     IntPtr hierarchyPtr, selectionContainerPtr; 7        uint projectItemId; 8        IVsMultiItemSelect mis; 9        IVsMonitorSelection monitorSelection = (IVsMonitorSelection)Package.GetGlobalService(typeof(SVsShellMonitorSelection));10        monitorSelection.GetCurrentSelection(out hierarchyPtr, out projectItemId, out mis, out selectionContainerPtr);11 12        IVsHierarchy hierarchy = Marshal.GetTypedObjectForIUnknown(hierarchyPtr, typeof(IVsHierarchy)) as IVsHierarchy;13        if (hierarchy != null)14     {15       object value;16           hierarchy.GetProperty(projectItemId, (int)__VSHPROPID.VSHPROPID_Name, out value);17 18           if (value != null && value.ToString().EndsWith(".xml", StringComparison.OrdinalIgnoreCase))19           {20             menuCommand.Visible = true;21           }22           else23           {24             menuCommand.Visible = false;25           }26     }27  }28 }

 到此,在xml文件的右键菜单里添加命令的功能已经实现。

五、点击命令的时候添加元素

添加功能可以在MenuItemCallBack事件处理函数里进行操作,需要判断当前的xml文件是否是新建的,如果是需要加上根元素,为了防止用户是在根元素所在行的后面点击命令(这样就找不到根元素),所以在开始查找操作之前需要将光标移到第一行,然后根据查找的结果判断是否需要添加根元素。如果是新建的xml文件的话可以直接将xml元素信息添加到第一行后面,如果已经存在根元素,则将根元素的结束元素替换成xml元素信息,代码如下所示:

 

VS2013点击右键菜单命令添加xml元素插件开发