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. |