Partager via


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.

capture d’écran d’un contrôle de case à cocher dans le ruban Microsoft Paint.

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.

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

Élément de balisage CheckBox