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

Article
08/10/2011

Remarque
Cette documentation s'adresse aux développeurs .NET Framework qui veulent 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 (page éventuellement en anglais).

Cette rubrique fournit des informations sur la prise en charge d'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 afin d'utiliser la propriété ControlTypeProperty. Les conditions incluent des indications spécifiques pour l'arborescence UI Automation, les valeurs de propriété UI Automation et les modèles de contrôle .

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), (Activer/Désactiver) ou tertiaire (Activer, Désactiver, Indéterminé) à l'utilisateur.

Les sections suivantes définissent l'arborescence UI Automation, les propriétés, les modèles de contrôle et les événements requis pour le type de contrôle CheckBox. Les spécifications UI Automation s'appliquent à tous les contrôles de case à cocher, qu'il s'agisse de Windows Presentation Foundation (WPF), Win32 ou Windows Forms.

Cette rubrique comprend les sections suivantes.

Arborescence UI Automation requise
Modèles de contrôle UI Automation requis
Événements UI Automation requis
Action par défaut
Rubriques connexes

Arborescence UI Automation requise

Le tableau suivant représente l'affichage de contrôle et l'affichage du contenu de l'arborescence UI Automation concernant les contrôles de case à cocher et décrit ce qui peut être inclus dans chaque affichage. Pour plus d'informations sur l'arborescence UI Automation, consultez Vue d'ensemble de l'arborescence UI Automation.

Affichage de contrôle	Affichage du contenu
CheckBox	CheckBox

Remarque
Les cases à cocher n'ont jamais d'éléments enfants dans l'affichage de contrôle ou dans l'affichage du 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 requises

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	Consulter les remarques.	La valeur de cette propriété doit être unique dans tous les contrôles d'une application.
BoundingRectangleProperty	Consulter les remarques.	Le rectangle le plus éloigné qui contient l'ensemble du contrôle.
ClickablePointProperty	Consulter 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 substituer et fournir un point interactif.
ControlTypeProperty	CheckBox	Cette valeur est la même pour toutes les infrastructures d'interface utilisateur.
IsContentElementProperty	True	La valeur de cette propriété doit toujours être True. Cela signifie que le contrôle de case à cocher doit toujours être inclus dans l'affichage du contenu de l'arborescence UI Automation.
IsControlElementProperty	True	La valeur de cette propriété doit toujours être True. Cela signifie que le contrôle de case à cocher doit toujours être inclus dans l'affichage de contrôle de l'arborescence UI Automation.
IsKeyboardFocusableProperty	Consulter 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	Consulter 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 requis

Le tableau suivant répertorie les modèles de contrôle UI Automation qui doivent être pris en charge par tous les contrôles de case à cocher. Pour plus d'informations sur les modèles de contrôle, consultez Vue d'ensemble des modèles de contrôle UI Automation.

Modèle de contrôle	Prise en charge	Remarques
IToggleProvider	Obligatoire	Permet que la case à cocher puisse passer d'un état interne à l'autre par programme.

Événements UI Automation requis

Le tableau suivant répertorie les événements UI Automation qui doivent ê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	Prise en charge	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 est de donner le focus à une case d'option et de basculer son état actuel. Comme mentionné précédemment, les cases à cocher présentent une décision binaire (Oui/Non), (Activer/Désactiver) ou tertiaire (Activer, Désactiver, Indéterminé) à l'utilisateur. Si la case à cocher est binaire, l'action par défaut provoque le passage de l'état « Activer » à l'état « Désactiver » ou inversement. Dans le cas d'une case à cocher à l'état tertiaire, l'action par défaut parcourt les états de la case à cocher dans le même ordre que si l'utilisateur avait envoyé des clics de souris consécutifs au contrôle.