Pulsante di menu combinato
Il pulsante di divisione è un controllo composito con cui l'utente può selezionare un valore predefinito associato a un pulsante primario oppure selezionare da un elenco di valori che si escludono a vicenda visualizzati in un elenco a discesa associato a un pulsante secondario.
Introduzione
Questo controllo è utile per esporre elementi strettamente correlati nei casi in cui è disponibile un'impostazione predefinita ovvia e dove i singoli elementi possono essere rappresentati da un'immagine, un testo o entrambi.
Lo screenshot seguente illustra il pulsante di divisione della barra multifunzione.
Proprietà pulsante di divisione
Il framework della barra multifunzione definisce una raccolta di chiavi di proprietà per il controllo Pulsante di divisione.
In genere, una proprietà Split Button 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 Pulsante di divisione.
| Chiave proprietà | Note |
|---|---|
| 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 uno o più elementi figlio sono abilitati, UI_PKEY_Enabled è impostato su true (-1). Importante: La proprietà UI_PKEY_Enabled per il controllo Pulsante di divisione deve essere invalidata dopo l'abilitazione o la disabilitazione di uno o più elementi figlio. In questo modo il framework esegue una query sul valore della proprietà aggiornato e aggiorna lo stato del controllo Pulsante di divisione nell'interfaccia utente della barra multifunzione. |
| UI_PKEY_Keytip | Può essere aggiornato solo tramite invalidazione. |
| UI_PKEY_TooltipDescription | Può essere aggiornato solo tramite invalidazione. |
| UI_PKEY_TooltipTitle | Può essere aggiornato solo tramite invalidazione. |