Partager via


Case à cocher (référence de l’élément d’interface utilisateur MSAA)

Note

Cette rubrique décrit case à cocher objets à des fins de référence d’élément d’interface utilisateur MSAA. La création d’objets case à cocher dans différentes infrastructures d’interface utilisateur n’est pas décrite ici. Consultez la documentation de référence de l’API pour l’infrastructure d’interface utilisateur que vous utilisez.

Les cases à cocher permettent d’activer ou de désactiver une ou plusieurs fonctionnalités ou options d’un ensemble, généralement dans une boîte de dialogue. En règle générale, une case à cocher contient une petite zone avec du texte adjacent. Lorsqu’une option est activée, une coche s’affiche dans la zone.

Le nom de la classe de fenêtre pour une case à cocher est « BUTTON ».

Méthodes IAccessible

Les cases à cocher prennent en charge les méthodes IAccessible suivantes :

Méthode Commentaires
accDoDefaultAction La méthode accDoDefaultAction appelle PostMessage avec le message du bouton BM_CLICK pour cliquer sur la case à cocher.
accHitTest
accLocation
accNavigate
accSelect

Propriétés IAccessible

Les cases à cocher prennent en charge les propriétés IAccessible suivantes :

Propriété Commentaires
get_accChild
get_accChildCount La propriété ChildCount est égale à zéro.
get_accDefaultAction La propriété DefaultAction d’une case à cocher dépend de sa sélection. Une case à cocher qui n’est pas cochée a la valeur « Check » comme DefaultActionet une case à cocher sélectionnée a « Annuler la case » comme DefaultAction. La case DefaultAction pour une case à cocher à trois états est « Bascule ».
get_accDescription
accFocus
accKeyboardShortcut La propriété KeyboardShortcut est la touche d’accès de la case à cocher, qui est un caractère souligné dans le texte de la fenêtre du contrôle. Cette chaîne contient le caractère de clé d’accès ajouté à la chaîne « Alt+ ».
accHelp La propriété Name est obtenue à partir du texte de la fenêtre du contrôle (ou légende), qui s’affiche avec la case à cocher.
accHelpTopic
accName La propriété Name est obtenue à partir du texte de la fenêtre du contrôle (ou légende), qui s’affiche avec la case à cocher.
accParent La propriété Parent est une fenêtre (ROLE_SYSTEM_WINDOW) qui entoure le contrôle et a le même nom de propriété Name et de classe de fenêtre que le contrôle.
accRole La propriété Role est ROLE_SYSTEM_CHECKBUTTON.
accState La propriété State est une combinaison d’une ou plusieurs des valeurs de suivantes:STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_MIXED | STATE_SYSTEM_CHECKED | STATE_SYSTEM_NORMAL

interface IAccessible