Partager via

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

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 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 utiliser la ControlTypeProperty propriété. Les conditions incluent des instructions spécifiques pour la structure d’arborescence UI Automation, les valeurs de propriété UI Automation et les modèles de contrôle.

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 bitmap qui indique un choix que l’utilisateur peut effectuer 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 mutuellement exclusives. Par exemple, l’application peut présenter un groupe de cases d’option à partir desquels 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 sélectionnant la case d’option correspondante. En règle générale, l’utilisateur ne peut sélectionner qu’une seule option à la fois à partir d’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 requis pour le type de contrôle RadioButton. Les exigences UI Automation s’appliquent à tous les contrôles de liste, 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 d’option 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.

Vue contrôle Affichage de contenu
RadioButton RadioButton

Il n’y a pas d’enfants dans l’affichage contrôle ou dans la vue de contenu.

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 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 Remarques
AutomationIdProperty Consultez les notes. La valeur de cette propriété doit être unique sur tous les contrôles d’une application.
BoundingRectangleProperty Consultez les notes. Rectangle le plus externe qui contient l’ensemble du contrôle.
IsKeyboardFocusableProperty Consultez les notes. Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
NameProperty Consultez les notes. Le nom du contrôle de case d’option est le texte affiché à côté du bouton qui conserve l’état de sélection.
ClickablePointProperty Consultez les notes. Le point cliquable du contrôle de case d’option doit être un point qui définit la sélection sur la case d’option si vous cliquez avec un pointeur de souris.
LabeledByProperty Null Les cases d’option sont des contrôles d’étiquetage automatique.
ControlTypeProperty RadioButton Cette valeur est la même pour toutes les infrastructures d’interface utilisateur.
LocalizedControlTypeProperty « case d’option » Chaîne localisée correspondant au type de contrôle RadioButton.
IsContentElementProperty Vrai Le contrôle de case d’option est toujours inclus dans la vue de contenu de l’arborescence UI Automation.
IsControlElementProperty Vrai Le contrôle de case d’option est toujours inclus dans la vue 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 requis pour ê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 Vue d’ensemble des modèles de contrôle UI Automation.

Modèle de contrôle/Propriété du modèle de contrôle Prise en charge/valeur Remarques
ISelectionItemProvider Oui Tous les contrôles de case d’option doivent prendre en charge le modèle Élément de sélection pour pouvoir être sélectionnés.
SelectionContainer Consultez les notes. L’opération SelectionContainerProperty doit toujours être effectuée afin qu’un client UI Automation puisse déterminer les autres cases d’option d’un contexte spécifique qui se rapportent les uns aux autres. Pour la version Win32 de la case d’option, cette propriété ne sera pas prise en charge, car il n’est pas possible d’obtenir ces informations à partir de cette infrastructure héritée.
IToggleProvider Jamais La case d’option ne peut pas parcourir son état 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 requis pour être pris en charge par tous les contrôles de case d’option. Pour plus d’informations sur les événements, consultez vue d’ensemble des événements UI Automation.

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

Voir aussi