galerie In-Ribbon
La galerie In-Ribbon est un contrôle qui affiche une collection d’éléments ou de commandes associés dans le ruban. S’il y a trop d’éléments dans la galerie, une flèche de développement est fournie pour afficher le reste de la collection dans un volet développé.
Détails
La capture d’écran suivante illustre le contrôle Ruban In-Ribbon Galerie dans Microsoft Paint.
Propriétés de la galerie In-Ribbon
L’infrastructure ruban définit une collection de clés de propriété pour le contrôle galerie In-Ribbon.
En règle générale, une propriété galerie In-Ribbon est mise à jour dans l’interface utilisateur du ruban en invalidant la commande associée au contrôle via un appel à la méthode IUIFramework::InvalidateUICommand . L’événement d’invalidation est géré et la propriété est mise à jour définie par la méthode de rappel IUICommandHandler::UpdateProperty .
La méthode de rappel IUICommandHandler::UpdateProperty n’est pas exécutée et l’application a demandé une valeur de propriété mise à jour, jusqu’à ce que la propriété soit requise par l’infrastructure. Par exemple, lorsqu’un onglet est activé et qu’un contrôle est révélé dans l’interface utilisateur du ruban, ou lorsqu’une info-bulle est affichée.
Notes
Dans certains cas, une propriété peut être récupérée via la méthode IUIFramework::GetUICommandProperty et définie avec la méthode IUIFramework::SetUICommandProperty .
Le tableau suivant répertorie les clés de propriété associées au contrôle galerie In-Ribbon.
| Clé de propriété | Notes |
|---|---|
| UI_PKEY_Categories | Prend en charge IUIFramework::GetUICommandProperty et IUIFramework::SetUICommandProperty. |
| UI_PKEY_Enabled | Prend en charge IUIFramework::GetUICommandProperty et IUIFramework::SetUICommandProperty. |
| UI_PKEY_ItemsSource | Prend en charge IUIFramework::GetUICommandProperty et IUIFramework::SetUICommandProperty. |
| UI_PKEY_Keytip | Peut uniquement être mis à jour via l’invalidation. |
| UI_PKEY_Label | Peut uniquement être mis à jour via l’invalidation. |
| UI_PKEY_LargeHighContrastImage | Peut uniquement être mis à jour via l’invalidation. |
| UI_PKEY_LargeImage | Peut uniquement être mis à jour via l’invalidation. |
|
UI_PKEY_SelectedItem(valide uniquement pour une galerie d’éléments) |
Prend en charge IUIFramework::GetUICommandProperty et IUIFramework::SetUICommandProperty.
Note: Si la commande associée au contrôle est invalidée par un appel à IUIFramework::InvalidateUICommand, l’infrastructure interroge cette propriété quand UI_INVALIDATIONS_VALUE est passée comme valeur d’indicateurs. |
| UI_PKEY_SmallHighContrastImage | Peut uniquement être mis à jour via l’invalidation. |
| UI_PKEY_SmallImage | Peut uniquement être mis à jour via l’invalidation. |
| UI_PKEY_TooltipDescription | Peut uniquement être mis à jour via l’invalidation. |
| UI_PKEY_TooltipTitle | Peut uniquement être mis à jour via l’invalidation. |