Bouton partagé

  • Article

Le bouton Fractionner est un contrôle composite avec lequel l’utilisateur peut sélectionner une valeur par défaut liée à un bouton principal ou sélectionner dans une liste de valeurs mutuellement exclusives affichées dans une liste déroulante liée à un bouton secondaire.

Introduction

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, un texte ou les deux.

La capture d’écran suivante illustre le bouton De fractionnement du ruban.

capture d’écran d’un contrôle splitbutton dans un exemple de ruban.

Fractionner les propriétés du bouton

L’infrastructure ribbon définit une collection de clés de propriété pour le contrôle Fractionner le bouton.

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

Clé de propriété Notes
UI_PKEY_Enabled Prend en charge IUIFramework::GetUICommandProperty et IUIFramework::SetUICommandProperty.
Si tous les éléments enfants sont désactivés, l’infrastructure définit UI_PKEY_Enabled sur false (0). Sinon, si un ou plusieurs éléments enfants sont activés, UI_PKEY_Enabled est défini sur true (-1). Important :
La propriété UI_PKEY_Enabled du contrôle Fractionner le bouton doit être invalidée une fois qu’un ou plusieurs éléments enfants sont activés ou désactivés. Cela garantit que l’infrastructure interroge la valeur de la propriété mise à jour et actualise l’état du contrôle Fractionner le bouton dans l’interface utilisateur du ruban.
UI_PKEY_Keytip 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.

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

Élément de balisage SplitButton