演练:将工具栏添加到工具窗口

本演练演示如何将工具栏添加到工具窗口。 工具栏提供快速访问在工具窗口的命令。

工具栏是包含按钮绑定到命令的水平或垂直条带。 一个工具栏的长度在工具窗口的总是为与工具栏停靠工具窗口的宽度或高度，根据。

在工具窗口的工具栏是不将自动集成开发环境创建的 (IDE)。 必须先创建一个工具窗口的 VSPackage 添加这些程序模型。

不同于 IDE 的工具栏中，必须在停靠工具窗口的工具栏并且无法移动或自定义。 如果工具窗口 VSPackage 用托管代码编写，工具栏在窗口的上边缘总是停靠。 但是，因此，如果在 VSPackage umanaged 代码编写，工具栏中所有边缘可以停靠。

有关如何将工具栏添加到 IDE 的更多信息，请参见 演练:将工具栏添加到 IDE。

系统必备

若要完成本演练，您必须安装 Visual Studio 2010 SDK。

备注

有关 Visual Studio SDK 的更多信息，请参见 扩展 Visual Studio 概述。若要查找有关中所列如何下载 Visual Studio SDK，请 Visual Studio Extensibility Developer Center 参见 MSDN 网站上。

Visual Studio 包 " 项目模板的位置

Visual Studio 包 " 项目模板可在 新项目 对话框的三个位置:

• 在 Visual Basic 扩展性下。 该项的默认语言是 Visual Basic。

• 在 C# 扩展性下。 该项目的默认语言是 C#。

• 在 其他项目类型扩展性下。 该项的默认语言是 C++。

创建工具窗口的 VSPackage

本节演示如何使用 Visual Studio 包 " 项目模板创建支持一个菜单命令的工具窗口 VSPackage。

创建 TWToolbar VSPackage

1. 创建名为 TW 的 VSPackage工具栏。 有关更多信息，请参见 演练:使用 Visual Studio 创建包模板的菜单命令。

2. 设置编程语言。 Visual Basic 或 Visual C#，然后选择 菜单命令 和 工具窗口 选项。

3. 在 命令选项下，设置命令名称。 TWTest 命令和命令 ID 设置为 cmdidTWTestCmd。

4. 在 工具窗口 " 选项卡下，将窗口名称。 测试工具窗口和命令 ID 设置为 cmdidTestTool。

创建工具窗口的工具栏

创建工具窗口的工具栏

1. 在文本编辑器中打开 TWToolbar.vsct。

2. 在 Symbols 部分，在名为 “guidTWToolbarCmdSet” GuidSymbol 节点，声明工具栏和工具栏组，如下所示。

   <IDSymbol name="TWToolbar" value="0x1000" />
   <IDSymbol name="TWToolbarGroup" value="0x1050" />
   

3. 在 Commands 部分的顶部，请创建一个 Menus 部分。

   <Menus></Menus>
   

   ，因为 VSCT 分析器在该级别，不区分在菜单和工具栏之间找到的工具栏定义示。

4. 添加一个 Menu 元素。 Menus 部分定义工具栏。

   <Menu guid="guidTWToolbarCmdSet" id="TWToolbar" type="ToolWindowToolbar">
     <CommandFlag>DefaultDocked</CommandFlag>
     <Strings>
       <ButtonText>Test Toolbar</ButtonText>
       <CommandName>Test Toolbar</CommandName>
     </Strings>
   </Menu>
   

   工具栏无法嵌套与子菜单。 因此，不必为父。 此外，，因为用户可以移动工具栏，不必设置优先。 通常情况下，工具栏的初始位置中定义以编程方式，但是，用户的后续已保存更改。

5. 在 Groups 部分，在现有组项之后，请定义一组包含工具栏上的命令。

   <Group guid="guidTWToolbarCmdSet" id="TWToolbarGroup" priority="0x0000">
     <Parent guid="guidTWToolbarCmdSet" id="TWToolbar" />
   </Group>
   

6. 在 Buttons 部分，更改现有 Button 元素的父级更改为工具栏组，以便工具栏将显示。

   <Button guid="guidTWToolbarCmdSet" id="cmdidTWTestCommand" priority="0x0100" type="Button">
     <Parent guid="guidTWToolbarCmdSet" id="TWToolbarGroup" />
     <Icon guid="guidImages" id="bmpPic1" />
     <Strings>
       <CommandName>cmdidTWTestCmd</CommandName>
       <ButtonText>TWTest Command</ButtonText>
     </Strings>
   </Button>
   

   默认情况下，因此，如果工具栏没有命令，而看起来。

   由于新工具栏不会自动添加到工具窗口由 Visual Studio IDE 工具栏，必须由 VSPackage 编程方式添加。 这将在下一节讨论， “将工具栏添加到工具窗口”。

将工具栏添加到工具窗口

将工具栏添加到工具窗口

1. 在 TWToolbar 项目中，打开 PkgCmdID.vb 或 PkgCmdID.cs 在文本编辑器中。

2. 在 PkgCmdID 文件中的现有命令 ID 之后，添加以下命令 ID.

   public const int TWToolbar = 0x1000;
   

3. 打开 MyToolWindow.vb 或 MyToolWindow.cs 在文本编辑器中。

4. 在文件的顶部，在其他 Imports 或 using 语句后，添加下面的行。

   using System.ComponentModel.Design; // for CommandID
   

5. 在 MyToolWindow 类构造函数，该构造函数开头，添加下面的行。

   this.ToolBar = new CommandID(
       GuidList.guidTWToolbarCmdSet,
       PkgCmdIDList.TWToolbar);
   

   此代码调用托管包结构 (MPF)创建工具窗口时的哪工具栏创建。

   备注

   在托管代码中，只有一个工具栏可以添加到工具窗口。

6. 在**“生成”菜单上，单击“生成解决方案”**以生成解决方案。

在测试工具窗口的工具栏

在测试工具窗口的工具栏

1. 按 F5 打开 Visual Studio 的实验实例中调试模式。

2. 在 视图 菜单上，指向 其他窗口 然后单击 测试工具窗口 显示工具窗口。

   通知工具栏显示在工具窗口下方的标题。

3. 在工具窗口工具栏上，单击图标显示消息 “内部 Company.TWToolbar.TW ToolbarPackage.MenuItemCallback()”。

请参见

任务

演练:将工具栏添加到 IDE

其他资源

命令、菜单和工具栏的演练

命令、菜单和工具栏