Dela via


Menygrupp

Menygruppen organiserar relaterade kommandon och kontroller i en meny eller ett verktygsfält.

Införandet

Kontrollen Menygrupp, som exponeras via MenuGroup-markeringselementet, är en logisk container för grupper av objekt eller kommandon i menybaserade kontroller, inklusive Popup- Mini-Toolbar.

En etikett kan anges för en menygrupp via attributet LabelTitle eller Command.LabelTitle egenskap för en associerad kommandodeklaration. Värdet som tilldelats LabelTitle återges som en kategorirubrik.

I följande exempel visas kommandomarkeringen för en delningsknapp kontroll som innehåller två kommandodeklarationer för menygrupper.

<!-- 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"/>

I följande exempel visas den markering som krävs för ett SplitButton--element med tre MenuGroup- elementdeklarationer, varav två är associerade med menygruppkommandona från föregående exempel. Attributet Class för elementet MenuGroup används för att ange storleken på menyalternativen.

<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>

Följande skärmbild illustrerar menyn (med tre menygruppskontroller) som genereras från markering i föregående exempel.

skärmbild av en meny med tre menygruppskontroller.

Menyfliksområdet definierar en samling egenskapsnycklar för kontrollen Menygrupp.

Vanligtvis uppdateras en menygruppsegenskap i menyfliksområdets användargränssnitt genom att kommandot som är associerat med kontrollen ogiltigförklaras via ett anrop till metoden IUIFramework::InvalidateUICommand. Ogiltighetshändelsen hanteras och egenskapsuppdateringarna definieras av IUICommandHandler::UpdateProperty återanropsmetod.

Metoden IUICommandHandler::UpdateProperty motringning körs inte och programmet efterfrågade ett uppdaterat egenskapsvärde tills egenskapen krävs av ramverket. Till exempel när en flik aktiveras och en kontroll visas i menyfliksområdets användargränssnitt, eller när en knappbeskrivning visas.

Not

I vissa fall kan en egenskap hämtas via metoden IUIFramework::GetUICommandProperty och anges med metoden IUIFramework::SetUICommandProperty.

 

I följande tabell visas de egenskapsnycklar som är associerade med kontrollen Menygrupp.

Egenskapsnyckel Anteckningar
UI_PKEY_Enabled Stöder IUIFramework::GetUICommandProperty och IUIFramework::SetUICommandProperty.
UI_PKEY_Keytip Kan bara uppdateras genom ogiltighet.
UI_PKEY_Label Kan bara uppdateras genom ogiltighet.
UI_PKEY_TooltipDescription Kan bara uppdateras genom ogiltighet.
UI_PKEY_TooltipTitle Kan bara uppdateras genom ogiltighet.

 

Kontrollbibliotek för Windows Ribbon Framework

MenuGroup-markeringselement