Gruppo (Windows Ribbon Framework)
Il gruppo organizza comandi e controlli correlati all'interno di una scheda.
Dettagli
La schermata seguente illustra il controllo Gruppo della barra multifunzione.
Proprietà gruppo
Il framework della barra multifunzione definisce una raccolta di chiavi di proprietà per il controllo Group.
In genere, una proprietà Group 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 Group.
| Chiave della proprietà | Note |
|---|---|
| UI_PKEY_Keytip | Può essere aggiornato solo tramite l'invalidazione.
Nota: Il framework richiede che il valore di UI_PKEY_Keytip per un controllo Group inizi con la lettera maiuscola Z. Se il valore fornito dall'applicazione nel metodo di callback IUICommandHandler::UpdateProperty non inizia con la lettera Z, questo valore viene ignorato e viene generato un valore dal framework. Il valore del framework è la lettera Z seguita da un valore numerico a partire da 1 e aumentando in sequenza, in base alle esigenze, per i controlli Group successivi (Z1, Z2, ..., Zx). |
| 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_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. |