再利用可能なボタンのグループを作成する

[アーティクル]
03/10/2023

コマンドグループは、メニューまたはツールバーに常に一緒に表示されるコマンドのコレクションです。すべてのコマンドグループは、.vsct ファイルの CommandPlacements セクションで別の親メニューに割り当てることで再利用できます。

通常、コマンドグループにはボタンが含まれますが、他のメニューやコンボボックスを含めることもできます。

再利用可能なボタンのグループを作成するには

ReusableButtons という名前の VSIX プロジェクトを作成します。詳細については、「メニューコマンドを使用した拡張機能の作成」を参照してください。
プロジェクトが開いたら、ReusableCommand という名前のカスタムコマンド項目テンプレートを追加します。 ソリューションエクスプローラーで、プロジェクトノードを右クリックして、[追加]>[新しい項目] の順に選択します。 [新しい項目の追加] ダイアログで、[Visual C#]>[機能拡張] の順にアクセスし、[カスタムコマンド] を選択します。ウィンドウの下部にある [名前] フィールドで、コマンドファイル名を ReusableCommand.cs に変更します。
.vsctファイルの Symbols セクションに移動し、プロジェクトのグループとコマンドを含む GuidSymbol 要素を見つけます。名前は guidReusableCommandPackageCmdSet です。
次の例に示すように、グループに追加する各ボタンの IDSymbol を追加します。
```
<GuidSymbol name="guidReusableCommandPackageCmdSet" value="{7f383b2a-c6b9-4c1d-b4b8-a26dc5b60ca1}">
    <IDSymbol name="MyMenuGroup" value="0x1020" />
    <IDSymbol name="ReusableCommandId" value="0x0100" />
    <IDSymbol name="SecondReusableCommandId" value="0x0200" />
</GuidSymbol>
```
既定では、コマンド項目テンプレートによって、MyMenuGroup という名前のグループと指定した名前のボタンが、それぞれ IDSymbol エントリを使用して一緒に作成されます。
Groups セクションで、Symbols セクションで指定したのと同じ GUID および ID 属性を含む Group 要素を作成します。また、既存のグループを使用したり、次の例に示すように、コマンドテンプレートによって提供されるエントリを使用したりすることもできます。このグループは、[ツール] メニューに表示されます。
```
<Groups>
    <Group guid="guidReusableCommandPackageCmdSet" id="MyMenuGroup" priority="0x0600">
          <Parent guid="guidSHLMainMenu" id="IDM_VS_MENU_TOOLS"/>
    </Group>
</Groups>
```

再利用するためにボタンのグループを作成するには

コマンドまたはメニューをグループに含めるには、コマンドまたはメニューの定義でそのグループを親として使用するか、CommandPlacements セクションを使用してコマンドまたはメニューをグループに配置します。

Buttons セクションで、グループが親になるようにボタンを定義するか、次の例に示すように、パッケージテンプレートによって提供されるボタンを使用します。
```
<Button guid="guidReusableCommandPackageCmdSet" id="ReusableCommandId" priority="0x0100" type="Button">
    <Parent guid="guidReusableCommandPackageCmdSet" id="MyMenuGroup" />
    <Icon guid="guidImages" id="bmpPic1" />
    <Strings>
        <ButtonText>Invoke ReusableCommand</ButtonText>
    </Strings>
</Button>
```
1 つのボタンを複数のグループに表示する必要がある場合は、そのためのエントリを CommandPlacements セクション (Commands セクションの後に配置する必要がある) に作成します。次の例に示すように、CommandPlacement 要素の GUID および ID 属性を配置するボタンに合わせて設定し、Parent 要素の GUID および ID をターゲットグループに合わせて設定します。
```
<CommandPlacements>
    <CommandPlacement guid="guidReusableCommandPackageCmdSet" id="SecondReusableCommandId" priority="0x105">
      <Parent guid="guidReusableCommandPackageCmdSet" id="MyMenuGroup" />
    </CommandPlacement>
</CommandPlacements>
```
Note

Priority フィールドの値によって、新しいコマンドグループ内でのコマンドの位置が決まります。 CommandPlacement 要素で設定された優先順位は、項目定義での設定をオーバーライドします。優先順位の値が低いコマンドは、優先順位の値が高いコマンドよりも前に表示されます。重複する値を優先順位に指定できますが、優先順位の値が同じコマンドの相対的な位置は保証されません。devenv /setup コマンドによって最終的なインターフェイスがレジストリから作成される順序に一貫性がないためです。

CommandPlacements セクションにエントリを作成します。 CommandPlacement 要素の GUID と ID をグループのものに設定し、親の GUID と ID をターゲットの場所のものに設定します。

CommandPlacements セクションは、Commands セクションの直後に配置する必要があります。
```
<CommandTable>
...
  <Commands>... </Commands>
  <CommandPlacements>... </CommandPlacements>
...
</CommandTable>
```
コマンドグループは、複数のメニューに含めることができます。親メニューとして使用できるのは、自分で作成したもの、Visual Studio (ShellCmdDef.vsct または SharedCmdDef.vsct に記述されている) で提供されるもの、または別の VSPackage で定義されるものです。親メニューが最終的に Visual Studio または VSPackage によって表示されるショートカットメニューに結び付けられる限り、親の階層数に制限はありません。

次の例では、ソリューションエクスプローラーのツールバーの他のボタンの右側に、グループを配置しています。
```
<CommandPlacements>
    <CommandPlacement guid="guidReusableCommandPackageCmdSet" id="MyMenuGroup" priority="0xF00">
      <Parent guid="guidSHLMainMenu" id="IDM_VS_TOOL_PROJWIN"/>
    </CommandPlacement>
</CommandPlacements>
```
```
<CommandPlacements>
  <CommandPlacement guid="guidButtonGroupCmdSet" id="MyMenuGroup"
      priority="0x605">
    <Parent guid="guidSHLMainMenu" id="IDM_VS_MENU_TOOLS" />
  </CommandPlacement>
</CommandPlacements>
```

再利用可能なボタンのグループを作成する

再利用可能なボタンのグループを作成するには

再利用するためにボタンのグループを作成するには

再利用可能なボタンのグループをメニューに配置するには

その他のリソース