Condividi tramite


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.

screenshot di un controllo splitbutton in una barra multifunzione di esempio.

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.

Libreria di controlli di Windows Ribbon Framework

Elemento di markup SplitButton