Dela via


In-Ribbon galleri

In-Ribbon-galleriet är en kontroll som visar en samling relaterade objekt eller kommandon i menyfliksområdet. Om det finns för många objekt i galleriet tillhandahålls en expanderande pil för att visa resten av samlingen i ett expanderat fönster.

Detaljer

Följande skärmbild illustrerar kontrollen Ribbon In-Ribbon Gallery i Microsoft Paint.

skärmdump av en inribbongallery kontroll i Microsofts färgband.

Menyfliksområdet definierar en samling egenskapsnycklar för kontrollen In-Ribbon Gallery.

Vanligtvis uppdateras en In-Ribbon Gallery-egenskap 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 In-Ribbon Gallery.

Egenskapsnyckel Anteckningar
UI_PKEY_Categories Stöder IUIFramework::GetUICommandProperty och IUIFramework::SetUICommandProperty.
UI_PKEY_Enabled Stöder IUIFramework::GetUICommandProperty och IUIFramework::SetUICommandProperty.
UI_PKEY_ItemsSource 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_LargeHighContrastImage Kan bara uppdateras genom ogiltighet.
UI_PKEY_LargeImage Kan bara uppdateras genom ogiltighet.
UI_PKEY_SelectedItem(endast giltigt för ett objektgalleri)
Stöder IUIFramework::GetUICommandProperty och IUIFramework::SetUICommandProperty. Obs! Om kommandot som är associerat med kontrollen är ogiltigt via ett anrop till IUIFramework::InvalidateUICommandfrågar ramverket den här egenskapen när UI_INVALIDATIONS_VALUE skickas som värdet för flaggor.
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

InRibbonGallery-element

Arbeta med gallerier

galleriexempel