raccolta Drop-Down
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.
Proprietà della raccolta Drop-Down
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. |