Galerie de boutons partagés
La bibliothèque de boutons partagés est un contrôle composite qui contient un bouton principal qui expose un seul élément ou une seule commande par défaut, et un bouton secondaire qui, lorsque vous cliquez dessus, affiche le reste de l’élément ou de la collection de commandes dans une liste déroulante mutuellement exclusive.
Détails
Ce contrôle est utile pour exposer des éléments étroitement liés dans les cas où une valeur par défaut évidente est disponible et où les éléments individuels peuvent être représentés par une image, du texte, ou les deux.
La capture d’écran suivante illustre la Galerie du bouton partagé du ruban dans Microsoft Paint.

Propriétés de la bibliothèque du bouton partagé
L’infrastructure du ruban définit une collection de clés de propriété pour le contrôle de la Galerie de boutons partagés.
En règle générale, une propriété de la bibliothèque de boutons partagés est mise à jour dans l’interface 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 les mises à jour de la propriété sont définies 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 interrogé une valeur de propriété mise à jour, jusqu’à ce que la propriété soit requise par le Framework. Par exemple, lorsqu’un onglet est activé et qu’un contrôle est affiché dans l’interface ruban, ou lorsqu’une info-bulle est affichée.
Notes
Dans certains cas, une propriété peut être récupérée par le biais de 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 de Galerie de boutons partagés.
| Clé de propriété | Notes |
|---|---|
| UI_PKEY_BooleanValue | Prend en charge IUIFramework :: GetUICommandProperty et IUIFramework :: SetUICommandProperty. |
| 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 par le biais d’une invalidation. |
| UI_PKEY_Label | Peut uniquement être mis à jour par le biais d’une invalidation. |
| UI_PKEY_LargeHighContrastImage | Peut uniquement être mis à jour par le biais d’une invalidation. |
| UI_PKEY_LargeImage | Peut uniquement être mis à jour par le biais d’une invalidation. |
| UI_PKEY_SelectedItem(valide uniquement pour une galerie d’éléments) |
Prend en charge IUIFramework :: GetUICommandProperty et IUIFramework :: SetUICommandProperty.[!Note] |
| UI_PKEY_SmallHighContrastImage | Peut uniquement être mis à jour par le biais d’une invalidation. |
| UI_PKEY_SmallImage | Peut uniquement être mis à jour par le biais d’une invalidation. |
| UI_PKEY_TooltipDescription | Peut uniquement être mis à jour par le biais d’une invalidation. |
| UI_PKEY_TooltipTitle | Peut uniquement être mis à jour par le biais d’une invalidation. |