ツールウィンドウへのツールバーの追加 - Visual Studio (Windows)

[アーティクル]
12/15/2023

このチュートリアルでは、ツールウィンドウにツールバーを追加する方法について説明します。

ツールバーとは、コマンドにバインドされたボタンを含む、水平または垂直のストリップです。ツールウィンドウのツールバーの長さは、ツールバーがドッキングされている場所に応じて、ツールウィンドウの幅または高さと常に同じになります。

IDE のツールバーとは異なり、ツールウィンドウのツールバーはドッキングされている必要があり、移動することもカスタマイズすることもできません。 VSPackage がアンマネージドコードで記述されている場合は、このツールバーをどの端にもドッキングできます。

ツールバーを追加する方法の詳細については、「ツールバーの追加」をご覧ください。

TWTestCommand という名前のメニューコマンドと TestToolWindow という名前のツールウィンドウの両方を含む、TWToolbar という名前の VSIX プロジェクトを作成します。詳細については、「メニューコマンドを使用して拡張機能を作成する」および「ツールウィンドウで拡張機能を作成する」をご覧ください。ツールウィンドウテンプレートを追加する前に、コマンド項目テンプレートを追加する必要があります。
TWTestCommandPackage.vsct で、Symbols セクションを探します。 guidTWTestCommandPackageCmdSet という名前の GuidSymbol ノードで、次のようにツールバーとツールバーグループを宣言します。
```
<IDSymbol name="TWToolbar" value="0x1000" />
<IDSymbol name="TWToolbarGroup" value="0x1050" />
```
Commands セクションの最上部に、Menus セクションを作成します。 Menu 要素を追加して、ツールバーを定義します。
```
<Menus>
    <Menu guid="guidTWTestCommandPackageCmdSet" id="TWToolbar" type="ToolWindowToolbar">
        <CommandFlag>DefaultDocked</CommandFlag>
        <Strings>
            <ButtonText>Test Toolbar</ButtonText>
            <CommandName>Test Toolbar</CommandName>
        </Strings>
    </Menu>
</Menus>
```
ツールバーは、サブメニューのように入れ子にすることはできません。したがって、親を割り当てる必要はありません。また、ユーザーはツールバーを移動できるため、優先度を設定する必要もありません。通常、ツールバーの最初の配置はプログラムによって定義されますが、ユーザーによるその後の変更は保持されます。

Groups セクションで、ツールバーのコマンドを格納するグループを定義します。


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

Buttons セクションで、既存の Button 要素の親をそのツールバーグループに変更して、ツールバーが表示されるようにします。
```
<Button guid="guidTWTestCommandPackageCmdSet" id="TWTestCommandId" priority="0x0100" type="Button">
    <Parent guid="guidTWTestCommandPackageCmdSet" id="TWToolbarGroup" />
    <Icon guid="guidImages" id="bmpPic1" />
    <Strings>
        <ButtonText>Invoke TWTestCommand</ButtonText>
    </Strings>
</Button>
```
既定では、ツールバーにコマンドがない場合、ツールバーは表示されません。

ツールウィンドウに新しいツールバーが自動的に追加されることはないため、ツールバーは明示的に追加する必要があります。これについては、次のセクションで説明します。

TWTestCommandPackageGuids.cs に、次の行を追加します。

public const string guidTWTestCommandPackageCmdSet = "00000000-0000-0000-0000-0000";  // get the GUID from the .vsct file
public const int TWToolbar = 0x1000;

TestToolWindow.cs に、次の using ステートメントを追加します。
```
using System.ComponentModel.Design;
```

TestToolWindow コンストラクターに、次の行を追加します。

this.ToolBar = new CommandID(new Guid(TWTestCommandPackageGuids.guidTWTestCommandPackageCmdSet), TWTestCommandPackageGuids.TWToolbar);

プロジェクトをビルドし、デバッグを開始します。 Visual Studio の実験用インスタンスが表示されます。
[表示] メニューの [その他のウィンドウ] で、[ToolWindow のテスト] をクリックしてツールウィンドウを表示します。

ツールウィンドウの左上の、タイトルのすぐ下にツールバー (既定のアイコンのように見える) が表示されます。
ツールバーで、そのアイコンをクリックすると、TWTestCommandPackage Inside TWToolbar.TWTestCommand.MenuItemCallback() というメッセージが表示されます。

ツールバーの追加

次の方法で共有

その他のリソース

次の方法で共有

ツール ウィンドウにツール バーを追加する

ツール ウィンドウのツール バーを作成する

ツール ウィンドウにツール バーを追加する

ツール ウィンドウのツールバーをテストする

関連するコンテンツ

その他のリソース

ツールウィンドウにツールバーを追加する

ツールウィンドウのツールバーを作成する

ツールウィンドウにツールバーを追加する

ツールウィンドウのツールバーをテストする