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.
Egenskaper för menygrupp
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. |
Relaterade ämnen