Bouton (Windows Ribbon Framework)

Le bouton est un contrôle sur lequel l’utilisateur peut cliquer pour fournir une entrée à une application.

• Introduction
• Propriétés du bouton
• Rubriques connexes

Introduction

La capture d’écran suivante contient trois exemples de l’élément Button Ribbon.

Propriétés du bouton

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

En règle générale, une propriété Button 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 Button.

Clé de propriété	Notes
UI_PKEY_Enabled	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_LabelDescription	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_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.

 

Rubriques connexes

Bibliothèque de contrôle de l’infrastructure du ruban Windows

Élément de balisage button