Condividi tramite

raccolta In-Ribbon

  • Articolo

La In-Ribbon Gallery è un controllo che visualizza una raccolta di elementi o comandi correlati nella barra multifunzione. Se nella raccolta sono presenti troppi elementi, viene fornita una freccia di espansione per visualizzare il resto della raccolta in un riquadro espanso.

Dettagli

Nella schermata seguente viene illustrato il controllo Barra multifunzione In-Ribbon Raccolta in Microsoft Paint.

schermata di un controllo inribbongallery nella barra multifunzione di vernice Microsoft.

Il framework della barra multifunzione definisce una raccolta di chiavi di proprietà per il controllo raccolta In-Ribbon.

In genere, una proprietà In-Ribbon Gallery viene aggiornata nell'interfaccia utente della barra multifunzione invalidando il comando associato al controllo tramite una chiamata al metodo IUIFramework::InvalidateUICommand . L'evento di invalidazione viene gestito e gli aggiornamenti delle proprietà definiti dal metodo di callback IUICommandHandler::UpdateProperty .

Il metodo di callback IUICommandHandler::UpdateProperty non viene eseguito e l'applicazione esegue una query per un valore di proprietà aggiornato, fino a quando la proprietà non è richiesta dal framework. Ad esempio, quando viene attivata una scheda e un controllo visualizzato nell'interfaccia utente della barra multifunzione o quando viene visualizzata una descrizione comando.

Nota

In alcuni casi, una proprietà può essere recuperata tramite il metodo IUIFramework::GetUICommandProperty e impostato con il metodo IUIFramework::SetUICommandProperty.

Nella tabella seguente sono elencate le chiavi delle proprietà associate al controllo In-Ribbon Gallery.

Chiave della proprietà Note
UI_PKEY_Categories Supporta IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty.
UI_PKEY_Enabled Supporta IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty.
UI_PKEY_ItemsSource Supporta IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty.
UI_PKEY_Keytip Può essere aggiornato solo tramite l'invalidazione.
UI_PKEY_Label Può essere aggiornato solo tramite l'invalidazione.
UI_PKEY_LargeHighContrastImage Può essere aggiornato solo tramite l'invalidazione.
UI_PKEY_LargeImage Può essere aggiornato solo tramite l'invalidazione.
UI_PKEY_SelectedItem(valido solo per una raccolta di elementi)
 Supporta IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty. Nota: Se il comando associato al controllo non è valido tramite una chiamata a IUIFramework::InvalidateUICommand, il framework esegue una query su questa proprietà quando UI_INVALIDATIONS_VALUE viene passato come valore di flag.
UI_PKEY_SmallHighContrastImage Può essere aggiornato solo tramite l'invalidazione.
UI_PKEY_SmallImage Può essere aggiornato solo tramite l'invalidazione.
UI_PKEY_TooltipDescription Può essere aggiornato solo tramite l'invalidazione.
UI_PKEY_TooltipTitle Può essere aggiornato solo tramite l'invalidazione.

Libreria di controllo di Windows Ribbon Framework

Elemento InRibbonGallery

Uso delle gallerie

Esempio di raccolta