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 esiste un valore predefinito ovvio e i singoli elementi possono essere rappresentati da un'immagine, un testo o entrambi.
Il supporto sia per le barre verticali che per i quadratini di ridimensionamento, o per il ridimensionamento, viene fornito tramite l'elemento DropDownGallery.MenuLayout.
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à 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 gli aggiornamenti delle proprietà definiti dal metodo di callback IUICommandHandler::UpdateProper ty.
L'IUICommandHandler::UpdateProperty metodo di callback 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 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 Drop-Down 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 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. |