Dela via


Grupp (Windows Ribbon Framework)

Gruppen organiserar relaterade kommandon och kontroller på en fliken.

Detaljer

Följande skärmbild illustrerar kontrollen Grupp i menyfliksområdet.

skärmbild med pratbubblar som visar en grupp.

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.

Kontrollbibliotek för Windows Ribbon Framework

gruppelement