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
• Proprietà pulsante a discesa
• Argomenti correlati

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.

Argomenti correlati

Libreria di controllo di Windows Ribbon Framework

Elemento markup DropDownButton