Prise en charge d'UI Automation pour le type de contrôle CheckBox
Notes
Cette documentation s’adresse 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 dernières informations 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 l’IU 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 de l’IU 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 (activé, désactivé, indéterminé) à 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 nécessaires pour le type de contrôle CheckBox. Les exigences UI Automation s’appliquent à tous les contrôles de case à cocher, que ce soit Windows Presentation Foundation (WPF), Win32 ou Windows Forms.
Arborescence UI Automation obligatoire
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. En outre, il décrit ce que peut contenir chaque affichage. Pour plus d’informations sur l’arborescence de l’IU Automation, consultez Vue d’ensemble de l’arborescence de l’IU Automation.
| Affichage de contrôle | Affichage de contenu |
|---|---|
| CheckBox | CheckBox |
Notes
Les cases à cocher n’ont jamais d’élément enfant dans l’affichage de contrôle ou de contenu. Si le contrôle ne doit pas contenir d’élément enfant, cela indique qu’un autre type de contrôle doit être utilisé.
Propriétés UI Automation obligatoires
Le tableau suivant liste 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 de l’IU Automation, consultez Propriétés de l’IU Automation pour les clients.
| Propriété UI Automation | Valeur | Notes |
|---|---|---|
| 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. | Pris 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 | CheckBox | Cette valeur est identique 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 de 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 du 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 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 UI Automation Control Patterns Overview.
| Modèle de contrôle | Support | Notes |
|---|---|---|
| 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 qui doivent être pris en charge par tous les contrôles de case à cocher. Pour plus d’informations sur les événements, consultez UI Automation Events Overview.
| Événement UI Automation | Support | Notes |
|---|---|---|
| AutomationFocusChangedEvent | Obligatoire | None |
| Événement de modification de propriétéBoundingRectangleProperty | Obligatoire | None |
| Événement de modification de propriétéIsOffscreenProperty | Obligatoire | None |
| Événement de modification de propriétéIsEnabledProperty | Obligatoire | None |
| StructureChangedEvent | Obligatoire | None |
| É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 placer le focus sur 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), (activé/désactivé), ou tertiaire (activé, désactivé, indéterminé). Si la case à cocher est binaire, l’action par défaut bascule l’état « activé » vers « désactivé » ou l’état « désactivé » vers « activé ». L’action par défaut d’une case à cocher en état tertiaire parcourt les états de la case à cocher dans le même ordre que si l’utilisateur avait cliqué successivement sur le contrôle.