Bouton Fractionner
Le bouton fractionné 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
- propriétés du bouton fractionné
- rubriques connexes
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 Fractionner le ruban.
Propriétés du bouton Fractionner
L’infrastructure du ruban définit une collection de clés de propriété pour le contrôle Bouton fractionné.
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 les mises à jour de propriétés définies par l'IUICommandHandler ::UpdateProperty méthode de rappel.
La méthode de rappel IUICommandHandler ::UpdateProperty n’est pas exécutée et l’application interrogée pour 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.
Note
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 Split Button.
| 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 a la valeur true (-1). Important : La propriété UI_PKEY_Enabled du contrôle Split Button 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 propriété mise à jour et actualise l’état du contrôle Bouton fractionné dans l’interface utilisateur du ruban. |
| UI_PKEY_Keytip | Ne peut être mis à jour qu’à l’aide d’une invalidation. |
| UI_PKEY_TooltipDescription | Ne peut être mis à jour qu’à l’aide d’une invalidation. |
| UI_PKEY_TooltipTitle | Ne peut être mis à jour qu’à l’aide d’une invalidation. |