Raccolta pulsanti di divisione
Split Button Gallery è un controllo composito che contiene un pulsante primario che espone un singolo elemento predefinito o comando e un pulsante secondario che, quando viene fatto clic, visualizza il resto dell'elemento o dell'insieme Command in un elenco a discesa esclusivo a vicenda.
Dettagli
Questo controllo è utile per esporre elementi strettamente correlati nei casi in cui è disponibile un valore predefinito ovvio e dove i singoli elementi possono essere rappresentati da un'immagine, un testo o entrambi.
Nella schermata seguente viene illustrata la raccolta pulsanti di divisione della barra multifunzione in Microsoft Paint.
Proprietà della raccolta pulsanti di divisione
Il framework della barra multifunzione definisce una raccolta di chiavi di proprietà per il controllo Split Button Gallery.
In genere, una proprietà Split Button 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::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 Split Button Gallery.
| Chiave della proprietà | Note |
|---|---|
| UI_PKEY_BooleanValue | Supporta IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty. |
| 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 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(valido solo per una raccolta di elementi) |
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. |