ツールバーとボタンを追加する (Visual Studio 拡張機能) - Visual Studio (Windows)

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

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

ツールバーとは、コマンドにバインドされたボタンを含む、水平または垂直のストリップです。 IDE のツールバーは、実装に応じて、再配置したり、メイン IDE ウィンドウの任意の辺にドッキングしたり、常に他のウィンドウより前面に表示させたりすることができます。

さらに、ユーザーは [カスタマイズ] ダイアログボックスを使用して、ツールバーでのコマンドの追加や削除を行えます。通常、VSPackage のツールバーはユーザーがカスタイズできます。カスタマイズはすべて IDE で処理され、コマンドへの応答は VSPackage で行われます。コマンドの物理的な配置場所が VSPackage で把握されている必要はありません。

メニューに関する詳細については、「コマンド、メニュー、およびツールバー」を参照してください。

IDEToolbar という名前の VSIX プロジェクトを作成します。 ToolbarTestCommand という名前のメニューコマンド項目テンプレートを追加します。この方法の詳細については、メニューコマンドを使用した拡張機能の作成に関するページをご覧ください。

ToolbarTestCommandPackage.vsct で、[Symbols] セクションを探します。 guidToolbarTestCommandPackageCmdSet という名前の GuidSymbol 要素で、次のようにツールバーとツールバーグループの宣言を追加します。
```
<IDSymbol name="Toolbar" value="0x1000" />
<IDSymbol name="ToolbarGroup" value="0x1050" />
```
[Commands] セクションの最上部で [Menus] セクションを作成します。 [Menus] セクションに [Menu] 要素を追加して、ツールバーを定義します。
```
<Menus>
    <Menu guid="guidToolbarTestCommandPackageCmdSet" id="Toolbar" type="Toolbar">
        <CommandFlag>DefaultDocked</CommandFlag>
        <Strings>
            <ButtonText>Test Toolbar</ButtonText>
            <CommandName>Test Toolbar</CommandName>
        </Strings>
    </Menu>
</Menus>
```
ツールバーをサブメニューのように入れ子にすることはできません。したがって、親グループを割り当てる必要はありません。また、ユーザーがツールバーを移動できるので、優先度を設定する必要もありません。通常、ツールバーの最初の配置はプログラムによって定義されますが、ユーザーによるその後の変更は保持されます。

[Groups] セクションの既存のグループエントリの後に、ツールバーのコマンドを含むように [Group] 要素を定義します。

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

ボタンをツールバーに表示させます。 [Buttons] セクションで、[Button] の [Parent] ブロックをツールバーに置き換えます。結果の [Button] ブロックは次のようになります。
```
<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>
```
既定では、ツールバーにコマンドがない場合、ツールバーは表示されません。
プロジェクトをビルドし、デバッグを開始します。実験用インスタンスが表示されます。
Visual Studio のメニューバーを右クリックして、ツールバーの一覧を表示します。 [ツールバーのテスト] を選択します。
これでツールバーは、[フォルダーを指定して検索] アイコンの右側にアイコンとして表示されているはずです。アイコンをクリックすると、「ToolbarTestCommandPackage. Inside IDEToolbar.ToolbarTestCommand.MenuItemCallback()」というメッセージボックスが表示されます。

コマンド、メニュー、およびツールバー

ツールバーを追加する

ツールバーを使用して拡張機能を作成する

IDE のツール バーを作成する

関連するコンテンツ

その他のリソース

IDE のツールバーを作成する