2.1将工具栏添加

将工具栏添加

Visual Studio 2015

其他版本

 

若要了解有关 Visual Studio 2017 RC 的最新文档，请参阅 Visual Studio 2017 RC 文档。

本演练演示如何将工具栏添加到 Visual Studio IDE。

工具栏是一个包含绑定到命令的按钮的水平或垂直条。 具体取决于其实现，在 IDE 中的工具栏可以重新定位、 停靠在主 IDE 窗口的任何一侧或保持在其他窗口前面。

此外，用户可以将命令添加到工具栏或通过从其移除它们自定义对话框。 通常情况下，在 Vspackage 中的工具栏是用户可自定义的。 IDE 处理所有自定义，并响应命令的 VSPackage。 VSPackage 不必知道命令是物理位置。

有关菜单的详细信息，请参阅命令、 菜单和工具栏。

先决条件

启动 Visual Studio 2015 中，您并不安装 Visual Studio SDK 从下载中心获得。 它将包括作为 Visual Studio 安装程序中的可选功能。 您还可以在以后安装 VS SDK。 有关详细信息，请参阅安装 Visual Studio SDK。

使用工具栏创建扩展

创建一个名为的 VSIX 项目IDEToolbar。 添加一个名为的菜单命令项模板ToolbarTestCommand。 有关如何执行此操作的信息，请参阅使用菜单命令创建扩展。

为 IDE 创建工具栏

1. 在 ToolbarTestCommandPackage.vsct，查找符号部分。 在名为 guidToolbarTestCommandPackageCmdSet GuidSymbol 元素中，添加一个工具栏和工具栏组中，声明，如下所示。

   XML

   <IDSymbol name="Toolbar" value="0x1000" />  
   <IDSymbol name="ToolbarGroup" value="0x1050" />  
   
   
   

2. 在命令部分顶部创建菜单部分。 将菜单元素添加到要定义您的工具栏上的菜单部分。

   XML

   <Menus>  
       <Menu guid="guidToolbarTestCommandPackageCmdSet" id="Toolbar"  
           type="Toolbar" >  
           <CommandFlag>DefaultDocked</CommandFlag>  
           <Strings>  
               <ButtonText>Test Toolbar</ButtonText>  
               <CommandName>Test Toolbar</CommandName>  
           </Strings>  
         </Menu>  
   </Menus>  
   
   

   不能像子菜单嵌套工具栏。 因此，无需分配父组。 此外，您无需设置优先级，因为用户可以移动工具栏。 通常，工具栏的初始位置，以编程方式定义，但由用户的后续更改将永久保存。

3. 在组部分中，在现有的组条目后, 定义组元素以包含工具栏上的命令。

   XML

   <Group guid="guidToolbarTestCommandPackageCmdSet" id="ToolbarGroup"  
         priority="0x0000">  
     <Parent guid="guidToolbarTestCommandPackageCmdSet" id="Toolbar"/>  
   </Group>  
   
   

4. 请在工具栏上显示的按钮。 在按钮部分中，替换到工具栏按钮中的父块。 生成的按钮块应如下所示︰

   XML

   <Button guid="guidToolbarTestCommandPackageCmdSet" id="ToolbarTestCommandId" priority="0x0100" type="Button">  
       <Parent guid= "guidToolbarTestCommandPackageCmdSet" id="ToolbarGroup" />  
               <Icon guid="guidImages" id="bmpPic1" />  
       <Strings>  
           <ButtonText>Invoke ToolbarTestCommand</ButtonText>  
       </Strings>  
   </Button>  
   
   

   默认情况下，如果工具栏不具有任何命令，则不会不显示。

5. 生成项目并启动调试。 应显示的实验实例。

6. 右键单击 Visual Studio 菜单栏，以获取工具栏的列表。 选择测试工具栏。

7. 您现在应看到您的工具栏上，作为文件图标中查找右侧的图标。 当您单击该图标时，您应看到一个消息框，指示ToolbarTestCommandPackage。内部 IDEToolbar.ToolbarTestCommand.MenuItemCallback()。