Case à cocher
La case à cocher est un contrôle sur lequel l’utilisateur peut cliquer pour fournir une entrée à une application. Le contrôle fournit un état bascule qui est représenté visuellement.
Détails
La case à cocher ne prend pas en charge un état tertiaire ou indéterminé.
La capture d’écran suivante illustre l’élément Case à cocher du ruban.
Propriétés de la case à cocher
L’infrastructure du ruban définit une collection de clés de propriété pour le contrôle Case à cocher.
En règle générale, une propriété Check Box 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 Case à cocher.
Clé de propriété | Notes |
---|---|
UI_PKEY_BooleanValue | Prend en charge IUIFramework::GetUICommandProperty et IUIFramework::SetUICommandProperty. Note: Si la commande associée au contrôle est invalidée par un appel à IUIFramework::InvalidateUICommand, l’infrastructure interroge cette propriété quand UI_INVALIDATIONS_VALUE est passée comme valeur d’indicateurs. |
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour