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

  • Article

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 d’UI Automation pour le type de contrôle RadioButton. 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 d’option se compose d’un bouton rond et d’un texte défini par l’application (étiquette), d’une icône ou d’une image bitmap qui indique un choix que l’utilisateur peut faire en sélectionnant le bouton. Une application utilise généralement des cases d’option dans une zone de groupe pour permettre à l’utilisateur de choisir parmi un ensemble d’options connexes mais s’excluant mutuellement. Par exemple, l’application peut présenter un groupe de cases d’option parmi lesquelles l’utilisateur peut sélectionner une préférence de format pour le texte sélectionné dans la zone cliente. L’utilisateur peut sélectionner un format aligné à gauche, aligné à droite ou centré en cochant la case d’option correspondante. En règle générale, l’utilisateur peut sélectionner une seule option à la fois parmi un ensemble de cases d’option.

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 RadioButton. Les exigences UI Automation s’appliquent à tous les contrôles de liste, 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 de contenu de l’arborescence UI Automation concernant les contrôles de case d’option. En outre, il décrit ce que peut contenir 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 de contenu
RadioButton RadioButton

Aucun enfant ne figure dans la vue de contrôle ni dans la vue de contenu.

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 le type de contrôle RadioButton. 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 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.
IsKeyboardFocusableProperty Consultez les remarques. Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
NameProperty Consultez les remarques. Le nom du contrôle de case d’option est le texte qui s’affiche en regard du bouton qui maintient l’état de sélection.
ClickablePointProperty Consultez les remarques. Le point interactif d’un contrôle de case d’option DOIT être un point qui définit la sélection sur la case d’option si l’utilisateur clique dessus avec le pointeur de souris.
LabeledByProperty Null Les cases d’option sont des contrôles à étiquetage automatique.
ControlTypeProperty RadioButton Cette valeur est identique pour toutes les infrastructures d’interface utilisateur.
LocalizedControlTypeProperty « case d’option » Chaîne localisée correspondant au type de contrôle RadioButton.
IsContentElementProperty True Le contrôle de case d’option est toujours inclus dans l’affichage de contenu de l’arborescence UI Automation.
IsControlElementProperty True Le contrôle de case d’option est toujours inclus dans l’affichage de contrôle de l’arborescence UI Automation.

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 d’option. Pour plus d’informations sur les modèles de contrôle, consultez UI Automation Control Patterns Overview.

Modèle de contrôle / Propriété de modèle de contrôle Prise en charge/valeur Notes
ISelectionItemProvider Oui Tous les contrôles de case d’option doivent prendre en charge le modèle Selection Item qui permet de les sélectionner.
SelectionContainer Consultez les remarques. La propriété SelectionContainerProperty doit toujours être définie afin qu’un client UI Automation puisse déterminer quelles autres cases d’option dans un contexte spécifique se rapportent les unes aux autres. Pour la version Win32 de la case d’option, cette propriété n’est pas prise en charge, car il n’est pas possible d’obtenir ces informations à partir de ce framework hérité.
IToggleProvider Jamais La case d’option ne peut pas passer d’un état à un autre une fois qu’elle a été définie. Ce modèle ne doit jamais être pris en charge sur la case d’option.

É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 d’option. Pour plus d’informations sur les événements, consultez UI Automation Events Overview.

Événement UI Automation Support Notes
ElementRemovedFromSelectionEvent Obligatoire None
ElementSelectedEvent Obligatoire None
Événement de modification de propriétéToggleStateProperty Jamais 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
AutomationFocusChangedEvent Obligatoire None
StructureChangedEvent Obligatoire None

Voir aussi