Galerie de In-Ribbon

La Galerie de In-Ribbon est un contrôle qui affiche une collection d’éléments ou de commandes connexes 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 ruban In-Ribbon le contrôle Gallery dans Microsoft Paint.

capture d’écran d’un contrôle inribbongallery dans le ruban Microsoft Paint.

L’infrastructure du ruban définit une collection de clés de propriété pour le contrôle In-Ribbon Gallery.

En règle générale, une propriété de la Galerie In-Ribbon 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 In-Ribbon Gallery.

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 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]
Si la commande associée au contrôle est invalidée via un appel à IUIFramework :: InvalidateUICommand, le Framework interroge cette propriété lorsque UI_INVALIDATIONS_VALUE est passé comme valeur d' indicateurs.

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.

Windows Bibliothèque de contrôles de Framework du ruban

Élément InRibbonGallery

Utilisation des galeries

Exemple de Galerie