メニューグループ

[アーティクル]
06/13/2023

メニューグループは、関連するコマンドとコントロールをメニューまたはツールバー内に整理します。

はじめに
メニューグループのプロパティ
関連トピック

はじめに

MenuGroup マークアップ要素を通じて公開されるメニューグループコントロールは、コンテキストポップアップミニツールバーを含むメニューベースのコントロール内の項目またはコマンドのグループの論理コンテナーです。

ラベルは、関連付けられた Command 宣言の LabelTitle 属性または Command.LabelTitle プロパティを使用して、メニューグループに指定できます。 LabelTitle に割り当てられた値は、カテゴリヘッダーとしてレンダリングされます。

次の例では、2 つのメニューグループコマンド宣言を含む分割ボタンコントロールの Command マークアップを示します。

<!-- SplitButton -->
<Command Name="cmdSplitButtonGroup"
         Symbol="cmdSplitButtonGroup"
         Comment="SplitButton Group"
         LabelTitle="SplitButton"/>
<Command Name="cmdSplitButton"
         Symbol="cmdSplitButton"
         Comment="SplitButton"
         LabelTitle="SplitButton"/>
<Command Name="cmdSBButtonItem"
         Symbol="cmdSBButtonItem"
         Comment="SBButtonItem"
         LabelTitle="SB ButtonItem"/>
<Command Name="cmdSBButton1"
         Symbol="cmdSBButton1"
         Comment="SBButton1"
         LabelTitle="SB Button">
  <Command.LargeImages>
    <Image Source="res/copyL_32.bmp"/>
  </Command.LargeImages>
  <Command.SmallImages>
    <Image Source="res/copyS_16.bmp"/>
  </Command.SmallImages>
  <Command.LargeHighContrastImages>
    <Image Source="res/copyLHC_32.bmp"/>
  </Command.LargeHighContrastImages>
  <Command.SmallHighContrastImages>
    <Image Source="res/copySHC_16.bmp"/>
  </Command.SmallHighContrastImages>
</Command>
<Command Name="cmdSBMajorItems"
         Comment="Major Items Category"
         LabelTitle="Major Items"/>
<Command Name="cmdSBStandardItems"
         Comment="Standard Items Category"
         LabelTitle="Standard Items"/>

次の例では、3 つの MenuGroup 要素宣言を持つ SplitButton 要素に必要なマークアップを示します。そのうちの 2 つが前の例の Menu Group Commands に関連付けられています。 MenuGroup 要素の Class 属性は、メニュー項目のサイズを指定するために使用されます。

<Group CommandName="cmdSplitButtonGroup">
  <SplitButton CommandName="cmdSplitButton">
    <SplitButton.ButtonItem>
      <Button CommandName="cmdSBButtonItem"/>
    </SplitButton.ButtonItem>
    <SplitButton.MenuGroups>
      <MenuGroup CommandName="cmdSBMajorItems" 
                 Class="MajorItems">
        <Button CommandName="cmdSBButton1"/>
        <Button CommandName="cmdSBButton1"/>
      </MenuGroup>
      <MenuGroup CommandName="cmdSBStandardItems"
                 Class="StandardItems">
        <Button CommandName="cmdSBButton1"/>
        <Button CommandName="cmdSBButton1"/>
      </MenuGroup>
      <MenuGroup Class="StandardItems">
        <Button CommandName="cmdSBButton1"/>
        <Button CommandName="cmdSBButton1"/>
      </MenuGroup>
    </SplitButton.MenuGroups>
  </SplitButton>
</Group>

次のスクリーンショットは、前の例のマークアップから生成されたメニュー (3 つのメニューグループコントロールを含む) を示しています。

3 つのメニューグループコントロールを含むメニューのスクリーンショット。

リボンフレームワークは、メニューグループコントロールのプロパティキーのコレクションを定義します。

通常、メニューグループプロパティは、 IUIFramework::InvalidateUICommand メソッドの呼び出しによってコントロールに関連付けられている Command を無効にすることで、リボン UI で更新されます。無効化イベントが処理され、 IUICommandHandler::UpdateProperty コールバックメソッドによって定義されたプロパティが更新されます。

IUICommandHandler::UpdateProperty コールバックメソッドは実行されず、アプリケーションは、フレームワークでプロパティが必要になるまで、更新されたプロパティ値を照会しました。たとえば、タブがアクティブ化され、リボン UI にコントロールが表示されたときや、ツールヒントが表示されたときなどです。

注意

場合によっては、 IUIFramework::GetUICommandProperty メソッドを使用してプロパティを取得し、 IUIFramework::SetUICommandProperty メソッドを使用して設定できます。

次の表に、メニューグループコントロールに関連付けられているプロパティキーの一覧を示します。

プロパティキー	メモ
UI_PKEY_Enabled	IUIFramework::GetUICommandProperty と IUIFramework::SetUICommandProperty をサポートします。
UI_PKEY_Keytip	無効化によってのみ更新できます。
UI_PKEY_Label	無効化によってのみ更新できます。
UI_PKEY_TooltipDescription	無効化によってのみ更新できます。
UI_PKEY_TooltipTitle	無効化によってのみ更新できます。

Windows リボンフレームワークコントロールライブラリ
MenuGroup マークアップ要素

次の方法で共有

はじめに