Prise en charge d'UI Automation pour le type de contrôle RadioButton
.gif "Remarque") 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'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 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 d'option se compose d'un bouton rond et d'un texte défini par l'application (une étiquette), d'une icône ou d'une bitmap qui indiquent le choix que peut faire l'utilisateur en sélectionnant le bouton. En général, une application utilise des cases d'option dans une zone de groupe pour permettre à l'utilisateur de choisir parmi un jeu d'options associées, mais qui s'excluent 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 activant la case d'option correspondante. En général, l'utilisateur ne peut sélectionner qu'une option à la fois dans un jeu de cases d'option.
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 RadioButton. Les spécifications UI Automation s'appliquent à tous les contrôles de liste, qu'il s'agisse de Windows Presentation Foundation (WPF), Win32 ou Windows Forms.
Cette rubrique comprend les sections suivantes.
- Arborescence UI Automation requise
- Propriétés UI Automation requises
- Modèles de contrôle UI Automation requis
- Événements UI Automation requis
- 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 d'option 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 |
|---|---|
RadioButton |
RadioButton |
Il n'y a aucun enfant dans l'affichage de contrôle et l'affichage du contenu.
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 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 |
|---|---|---|
Consulter les remarques. |
La valeur de cette propriété doit être unique dans tous les contrôles d'une application. |
|
Consulter les remarques. |
Le rectangle le plus éloigné contient l'ensemble du contrôle. |
|
Consulter les remarques. |
Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété. |
|
Consulter les remarques. |
Le nom du contrôle de case d'option est le texte affiché à côté du bouton qui maintient l'état de sélection. |
|
Consulter les remarques. |
Le point interactif du contrôle de case d'option DOIT être un point qui définit la sélection sur la case d'option lorsqu'on clique dessus avec le pointeur de la souris. |
|
Null |
Les cases d'option sont des contrôles à étiquetage automatique. |
|
RadioButton |
Cette valeur est la même pour toutes les infrastructures d'UI. |
|
"case d'option" |
Chaîne localisée correspondant au type de contrôle RadioButton. |
|
True |
Le contrôle de case d'option est toujours inclus dans l'affichage du contenu de l'arborescence UI Automation. |
|
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 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 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 |
|---|---|---|
Oui |
Tous les contrôles de case d'option doivent prendre en charge le modèle Selection Item pour pouvoir être sélectionnés. |
|
Consulter les remarques. |
SelectionContainerProperty doit toujours être exécuté pour permettre à un client UI Automation de déterminer les autres cases d'option qui sont associées dans un contexte spécifique. Pour la version Win32 de la case d'option, cette propriété ne sera pas prise en charge car il est impossible d'obtenir ces informations depuis cette infrastructure héritée. |
|
Jamais |
La case d'option ne peut pas passer d'un état à l'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 requis
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 Vue d'ensemble des événements UI Automation.
Événement UI Automation |
Prise en charge |
Remarques |
|---|---|---|
Obligatoire |
Aucun |
|
Obligatoire |
Aucun |
|
Événement de modification de propriété ToggleStateProperty. |
Jamais |
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 |
Obligatoire |
Aucun |
|
Obligatoire |
Aucun |