Grupp (Windows Ribbon Framework)
Gruppen organiserar relaterade kommandon och kontroller på en fliken.
Detaljer
Följande skärmbild illustrerar kontrollen Grupp i menyfliksområdet.
Gruppegenskaper
Menyfliksområdet definierar en samling egenskapsnycklar för gruppkontrollen.
Vanligtvis uppdateras en gruppegenskap 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 gruppkontrollen.
| Egenskapsnyckel | Anteckningar |
|---|---|
| UI_PKEY_Keytip | Kan bara uppdateras genom ogiltighet.
Obs! Ramverket kräver att värdet för UI_PKEY_Keytip för en gruppkontroll börjar med versal bokstaven Z. Om värdet som tillhandahålls av programmet i IUICommandHandler::UpdateProperty återanropsmetod inte börjar med bokstaven Z ignoreras det här värdet och ett värde genereras av ramverket i stället. Ramverksvärdet är bokstaven Z följt av ett numeriskt värde som börjar vid 1 och ökar sekventiellt, efter behov, för efterföljande gruppkontroller (Z1, Z2, ..., Zx). |
| UI_PKEY_Label | Kan bara uppdateras genom ogiltighet. |
| UI_PKEY_LargeHighContrastImage | Kan bara uppdateras genom ogiltighet. |
| UI_PKEY_LargeImage | Kan bara uppdateras genom ogiltighet. |
| UI_PKEY_SmallHighContrastImage | Kan bara uppdateras genom ogiltighet. |
| UI_PKEY_SmallImage | Kan bara uppdateras genom ogiltighet. |
| UI_PKEY_TooltipDescription | Kan bara uppdateras genom ogiltighet. |
| UI_PKEY_TooltipTitle | Kan bara uppdateras genom ogiltighet. |