Partager via

Prise en charge d'UI Automation pour le type de contrôle CheckBox

Remarque

Cette documentation est destinée aux développeurs .NET Framework qui souhaitent utiliser les classes UI Automation managées définies dans l’espace de noms System.Windows.Automation. Pour obtenir les informations les plus récentes sur UI Automation, consultez API Windows Automation : UI Automation.

Cette rubrique fournit des informations sur la prise en charge de Microsoft UI Automation pour le type de contrôle CheckBox. Dans UI Automation, un type de contrôle est un ensemble de conditions qu’un contrôle doit respecter pour pouvoir utiliser la propriété ControlTypeProperty. Les conditions incluent des instructions spécifiques pour la structure d’arborescence, les valeurs de propriété et les modèles de contrôle UI Automation.

Une case à cocher est un objet utilisé pour indiquer un état avec lequel les utilisateurs peuvent interagir pour parcourir cet état. Les cases à cocher présentent une option binaire (Oui/Non), (Activé/Désactivé) ou tertiaire (On, Off, Indeterminate) à l’utilisateur.

Les sections suivantes définissent la structure d’arborescence, les propriétés, les modèles de contrôle et les événements UI Automation requis pour le type de contrôle CheckBox. Les exigences UI Automation s’appliquent à tous les contrôles de case à cocher, que Windows Presentation Foundation (WPF), Win32 ou Windows Forms.

Arborescence UI Automation obligatoire

Le tableau suivant illustre l’affichage de contrôle et la vue de contenu de l’arborescence UI Automation qui se rapporte aux contrôles de case à cocher et décrit ce qui peut être contenu dans chaque vue. Pour plus d’informations sur l’arborescence UI Automation, consultez Vue d’ensemble de l’arborescence UI Automation.

Affichage de contrôle Affichage de contenu
Case à cocher Case à cocher

Remarque

Les cases à cocher n’ont jamais d’élément enfant dans l’affichage de contrôle ou de contenu. Si le contrôle doit contenir des éléments enfants, cela indique qu’un autre type de contrôle doit être utilisé.

Propriétés UI Automation obligatoires

Le tableau suivant répertorie les propriétés UI Automation dont la valeur ou la définition est particulièrement pertinente pour les contrôles de case à cocher. Pour plus d’informations sur les propriétés UI Automation, consultez Propriétés UI Automation pour les clients.

Propriété UI Automation Valeur Remarques
AutomationIdProperty Consultez les remarques. La valeur de cette propriété doit être unique dans tous les contrôles d’une application.
BoundingRectangleProperty Consultez les remarques. Rectangle externe qui contient l’ensemble du contrôle.
ClickablePointProperty Consultez les remarques. Prise en charge s’il existe un rectangle englobant. Si les points du rectangle englobant ne sont pas tous interactifs et que vous effectuez un test de positionnement spécialisé, vous devez remplacer et fournir un point interactif.
ControlTypeProperty Case à cocher Cette valeur est identique pour toutes les infrastructures d’interface utilisateur.
IsContentElementProperty Vrai La valeur de cette propriété doit toujours être True. Cela signifie que le contrôle de case à cocher doit toujours être inclus dans la vue de contenu de l’arborescence UI Automation.
IsControlElementProperty Vrai La valeur de cette propriété doit toujours être True. Cela signifie que le contrôle de case à cocher doit toujours être inclus dans la vue contrôle de l’arborescence UI Automation.
IsKeyboardFocusableProperty Consultez les remarques. Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
LabeledByProperty Null Les cases à cocher sont des contrôles à étiquetage automatique.
LocalizedControlTypeProperty « case à cocher » Chaîne localisée correspondant au type de contrôle CheckBox.
NameProperty Consultez les remarques. La valeur de la propriété Name du contrôle de case à cocher est le texte affiché à côté de la zone qui maintient l’état bascule.

Modèles de contrôle UI Automation obligatoires

Le tableau suivant répertorie les modèles de contrôle UI Automation requis pour être pris en charge par tous les contrôles de case à cocher. Pour plus d’informations sur les modèles de contrôle, consultez UI Automation Control Patterns Overview.

Modèle de contrôle Soutien Remarques
IToggleProvider Obligatoire Permet de parcourir les états internes de la case à cocher par programmation.

Événements UI Automation obligatoires

Le tableau suivant répertorie les événements UI Automation requis pour être pris en charge par tous les contrôles de case à cocher. Pour plus d’informations sur les événements, consultez Vue d’ensemble des événements UI Automation.

Événement UI Automation Soutien Remarques
AutomationFocusChangedEvent Obligatoire Aucun
Événement de modification de propriétéBoundingRectangleProperty Obligatoire Aucun
Événement de modification de propriétéIsOffscreenProperty Obligatoire Aucun
Événement de modification de propriétéIsEnabledProperty Obligatoire Aucun
StructureChangedEvent Obligatoire Aucun
Événement de modification de propriétéToggleStateProperty Obligatoire Aucun

Action par défaut

L’action par défaut de la case à cocher consiste à faire en sorte qu’une case d’option devienne prioritaire et bascule son état actuel. Comme mentionné précédemment, les cases à cocher présentent une décision binaire (Oui/Non) (Activé/Désactivé) à l’utilisateur ou à un tertiaire (Activé, Désactivé, Indéterminé). Si la case à cocher est binaire, l’action par défaut provoque l’état « activé » de devenir « désactivé » ou l’état « désactivé » pour devenir « activé ». Dans une case à cocher d’état tertiaire, l’action par défaut passe par les états de la case à cocher dans le même ordre que si l’utilisateur avait envoyé des clics de souris successifs au contrôle.

Voir aussi