Share via

raccolta Drop-Down

  • Articolo

La raccolta Drop-Down è costituita da un pulsante che quando si fa clic visualizza un elenco a discesa contenente una raccolta di elementi o comandi che si escludono a vicenda.

Dettagli

Questo controllo è utile per esporre elementi o comandi correlati in cui non è presente alcun valore predefinito ovvio e i singoli elementi possono essere rappresentati da un'immagine, un testo o entrambi.

Tramite l'elemento DropDownGallery.MenuLayout viene fornito il supporto sia per le barre verticali che per i quadratini di ridimensionamento o per i quadratini di ridimensionamento.

La schermata seguente illustra la barra multifunzione Drop-Down Gallery in Microsoft Paint.

screenshot di un controllo dropdowngallery nella barra multifunzione microsoft paint.

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

In genere, una proprietà di Drop-Down 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 le proprietà vengono aggiornate definite dal metodo di callback IUICommandHandler::UpdateProperty .

Il metodo di callback IUICommandHandler::UpdateProperty non viene eseguito e l'applicazione ha eseguito 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 viene visualizzato un controllo 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 impostata con il metodo IUIFramework::SetUICommandProperty .

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

Chiave 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 invalidazione.
UI_PKEY_Label Può essere aggiornato solo tramite invalidazione.
UI_PKEY_LargeHighContrastImage Può essere aggiornato solo tramite invalidazione.
UI_PKEY_LargeImage Può essere aggiornato solo tramite invalidazione.
UI_PKEY_SelectedItem(valido solo per una raccolta di elementi)
 Supporta IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty. Nota: Se il comando associato al controllo viene invalidato 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 invalidazione.
UI_PKEY_SmallImage Può essere aggiornato solo tramite invalidazione.
UI_PKEY_TooltipDescription Può essere aggiornato solo tramite invalidazione.
UI_PKEY_TooltipTitle Può essere aggiornato solo tramite invalidazione.

Libreria di controlli di Windows Ribbon Framework

Elemento di markup DropDownGallery

Uso delle raccolte

Esempio di raccolta