逐步解說：加入工具列至工具視窗

發行項
05/16/2015

這個逐步解說會示範如何將工具列新增到 [工具] 視窗。工具列提供快速存取 [工具] 視窗中的命令。

工具列是水平或垂直的區域包含繫結至命令的按鈕。在 [工具] 視窗工具列的長度一定是相同的寬度或高度的工具視窗中，會在停駐工具列而定。

工具列的工具視窗不是由整合式的開發環境 (IDE) 會自動建立。它們都必須透過建立工具視窗的 VSPackage 以程式設計方式加入。

不同於在 IDE 中的 [工具列]，在 [工具] 視窗中的工具列必須停駐和不能移動或自訂。如果工具視窗的 VSPackage 撰寫 managed 程式碼中，工具列永遠停駐在視窗的上邊緣。不過，如果 VSPackage 撰寫 umanaged 的程式碼中，工具列可停駐在任何邊緣。

如需有關如何將工具列新增到 IDE 的詳細資訊，請參閱逐步解說：對 IDE 加入工具列。

必要條件

若要完成這個逐步解說中，您必須安裝Visual Studio 2010 SDK。

注意事項
如需有關 Visual Studio 的 SDK 的詳細資訊，請參閱擴充 Visual Studio 的概觀。若要了解如何下載 Visual Studio 的 SDK，請參閱Visual Studio 擴充性開發人員中心 MSDN 網站上。

Visual Studio 的封裝專案範本的位置

Visual Studio 的封裝的專案範本有三個位置都在新的專案對話方塊：

在 Visual Basic 擴充性。專案的預設語言是 Visual Basic。
在 C# 擴充性。專案的預設語言是 C#。
在其他專案類型擴充性。專案的預設語言是 c + +。

建立工具視窗的 VSPackage

本節會示範如何使用Visual Studio套件] 專案範本來建立支援一個功能表命令的工具視窗 VSPackage。

若要建立 TWToolbar VSPackage

建立名為新細 VSPackage工具列。如需詳細資訊，請參閱逐步解說：使用 Visual Studio 的封裝範本建立功能表命令。
若要設定的程式語言 Visual Basic 或視覺 C#，，然後選取 [ 功能表命令 和 工具視窗選項。
在命令選項，將命令名稱設定為 TWTest 命令，和命令 ID，以 cmdidTWTestCmd。
在工具視窗選項，將視窗名稱設定為測試工具視窗，和命令 ID，以 cmdidTestTool。

建立工具視窗的工具列

若要建立工具視窗工具列

開啟 [文字編輯器] 中的 [TWToolbar.vsct]。
在Symbols一節，在GuidSymbol名為"guidTWToolbarCmdSet"，可宣告一個工具列和工具列的群組，如下所示。
```
<IDSymbol name="TWToolbar" value="0x1000" />
<IDSymbol name="TWToolbarGroup" value="0x1050" />
```
在頂端的Commands區段中，建立Menus一節。
```
<Menus></Menus>
```
工具列定義位於這裡因為 VSCT 剖析器不會辨別功能表和工具列，在此層級。
新增Menu項目Menus一節，以定義的工具列。
```
<Menu guid="guidTWToolbarCmdSet" id="TWToolbar" type="ToolWindowToolbar">
  <CommandFlag>DefaultDocked</CommandFlag>
  <Strings>
    <ButtonText>Test Toolbar</ButtonText>
    <CommandName>Test Toolbar</CommandName>
  </Strings>
</Menu>
```
無法巢狀工具列，像子功能表。因此，您沒有指定父代。此外，您不必設定優先順序，因為使用者可以移動工具列。一般而言，以程式設計的方式，定義的工具列的初始位置，但使用者的後續變更永久性的。

在Groups ] 區段中，現有的群組項目之後定義包含工具列的命令群組。

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

在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 本身。這被討論在下一步] 區段中，「加入工具列至工具視窗」。

將工具列新增到 [工具] 視窗

若要將工具列新增到 [工具] 視窗

在 TWToolbar 專案中，請在文字編輯器中開啟 PkgCmdID.vb 或 PkgCmdID.cs。
PkgCmdID 檔案中現有的命令 Id 後, 加上下列的命令 id。
```
public const int TWToolbar = 0x1000;
```
在文字編輯器中開啟 MyToolWindow.vb 或 MyToolWindow.cs。
在頂端的檔案，接著一個Imports或using陳述式，加入下面這一行。
```
using System.ComponentModel.Design; // for CommandID
```
在MyToolWindow類別建構函式，建構函式的開頭加入下面這一行。
```
this.ToolBar = new CommandID(
    GuidList.guidTWToolbarCmdSet,
    PkgCmdIDList.TWToolbar);
```
這段程式碼會告訴受管理的封裝架構 (MPF) 建立時建立工具視窗的工具列。

注意事項

在 managed 程式碼，可以新增多個工具列工具視窗。
按一下 [建置] 功能表上的 [建置方案]，即可建置此方案。

注意事項
在 managed 程式碼，可以新增多個工具列工具視窗。

在 [工具] 視窗中測試] 工具列

若要測試工具視窗中的工具列

按 F5 以開啟執行個體的實驗Visual Studio在偵錯模式。
在檢視功能表上指向 其他視窗 ，然後按一下 測試工具視窗以顯示 [工具] 視窗。

請注意要將工具列顯示工具視窗的標題下方。
在 [工具] 視窗工具列上按一下該圖示來顯示訊息「在 Company.TWToolbar.TWToolbarPackage.MenuItemCallback()"。

請參閱

工作

逐步解說：對 IDE 加入工具列

其他資源

命令、功能表和工具列的逐步解說

命令、功能表和工具列

共用方式為

逐步解說： 加入工具列至工具視窗

必要條件

Visual Studio 的封裝專案範本的位置

建立工具視窗的 VSPackage

若要建立 TWToolbar VSPackage

建立工具視窗的工具列

若要建立工具視窗工具列

將工具列新增到 [工具] 視窗

若要將工具列新增到 [工具] 視窗

在 [工具] 視窗中測試] 工具列

若要測試工具視窗中的工具列

請參閱

工作

其他資源

其他資源

逐步解說：加入工具列至工具視窗