pulsante Drop-Down
Il pulsante Drop-Down è costituito da un pulsante che quando si fa clic visualizza un elenco a discesa di elementi reciprocamente esclusivi.
Dettagli
Questo controllo è utile per esporre gli elementi strettamente correlati nei casi in cui non è disponibile alcun valore predefinito ovvio e dove i singoli elementi possono essere rappresentati da un'immagine, un testo o entrambi.
La schermata seguente illustra il pulsante della barra multifunzione Drop-Down in una barra multifunzione di esempio.
Drop-Down proprietà del pulsante
Il framework della barra multifunzione definisce una raccolta di chiavi di proprietà per il controllo Button Drop-Down.
In genere, una proprietà button Drop-Down 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 pulsante Drop-Down.
| Chiave della proprietà | Note |
|---|---|
| UI_PKEY_Categories | Supporta IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty. |
| UI_PKEY_Enabled | Supporta IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty. Se tutti gli elementi figlio sono disabilitati, il framework imposta UI_PKEY_Enabled su false (0). In caso contrario, se sono abilitati uno o più elementi figlio, UI_PKEY_Enabled è impostato su true (-1). Importante: La proprietà UI_PKEY_Enabled per il controllo pulsante Drop-Down deve essere invalidata dopo che uno o più elementi figlio sono abilitati o disabilitati. In questo modo il framework esegue una query sul valore della proprietà aggiornata e aggiorna lo stato del controllo pulsante Drop-Down nell'interfaccia utente della barra multifunzione. |
| 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 | 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. |