Type de contrôle RadioButton

  • Article

Cette rubrique fournit des informations sur la prise en charge de Microsoft UI Automation pour le type de contrôle RadioButton.

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.

Notes

Une autre généralisation de contrôle pour les boutons où un seul d’un groupe peut être sélectionné est le contenu d’un bouton bascule. Certaines infrastructures d’interface utilisateur considèrent une case d’option comme un bouton bascule spécialisé.

 

Les sections suivantes définissent les UI Automation l’arborescence requise, les propriétés, les modèles de contrôle et les événements pour le type de contrôle RadioButton. Les exigences UI Automation s’appliquent à tous les contrôles de bouton où l’infrastructure/plateforme de l’interface utilisateur intègre UI Automation prise en charge des types de contrôles et des modèles de contrôle.

Cette rubrique contient les sections suivantes.

Structure d’arborescence classique

Le tableau suivant illustre une vue de contrôle et de contenu typique de l’arborescence UI Automation qui se rapporte aux contrôles 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.

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 pertinentes

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 qui implémentent le type de contrôle RadioButton (tels que les contrôles de bouton). Pour plus d’informations sur les propriétés UI Automation, consultez Récupération des propriétés à partir d’éléments UI Automation.

Propriété UI Automation Valeur Notes
UIA_AutomationIdPropertyId Consultez les remarques. La valeur de cette propriété doit être unique parmi tous les éléments homologues dans la vue brute de l’arborescence UI Automation.
UIA_BoundingRectanglePropertyId Consultez les remarques. Rectangle externe qui contient l’ensemble du contrôle.
UIA_ClickablePointPropertyId Consultez les remarques. Le point cliquable doit être un point qui, lorsqu’il est cliqué, sélectionne la case d’option.
UIA_ControlTypePropertyId RadioButton
UIA_IsContentElementPropertyId true Le contrôle de case d’option est toujours inclus dans l’affichage de contenu de l’arborescence UI Automation.
UIA_IsControlElementPropertyId true Le contrôle de case d’option est toujours inclus dans l’affichage de contrôle de l’arborescence UI Automation.
UIA_IsKeyboardFocusablePropertyId Consultez les remarques. Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
UIA_LabeledByPropertyId NULL Les contrôles d’option sont auto-étiquetés par leur contenu.
UIA_LocalizedControlTypePropertyId Consultez les remarques. Chaîne localisée correspondant au type de contrôle RadioButton . La valeur par défaut est « case d’option » pour en-US ou English (États-Unis).
UIA_NamePropertyId Consultez 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.

 

Modèles de contrôle 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 UI Automation Control Patterns Overview.

Modèle de contrôle/Propriété de modèle Prise en charge/valeur Notes
ISelectionItemProvider Obligatoire Tous les contrôles d’option doivent prendre en charge le modèle de contrôle SelectionItem pour pouvoir être sélectionnés.
SelectionContainer Consultez les remarques. La propriété SelectionContainer doit toujours être terminée afin qu’un client UI Automation puisse déterminer les autres cases d’option d’un contexte spécifique liées les unes aux autres. Pour la version Microsoft 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 cette infrastructure héritée.
IToggleProvider Jamais La case d’option ne peut pas passer d’un état à un autre une fois qu’elle a été définie. Le modèle de contrôle Bascule ne doit jamais être pris en charge sur une case d’option.

 

Événements obligatoires

Le tableau suivant répertorie les événements UI Automation que les contrôles de bouton doivent prendre en charge. Pour plus d’informations sur les événements, consultez UI Automation Events Overview.

Événement UI Automation Notes
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId’événement de modification de propriété.
UIA_IsEnabledPropertyId’événement de modification de propriété. Si le contrôle prend en charge la propriété IsEnabled , il doit prendre en charge cet événement.
UIA_IsOffscreenPropertyId’événement de modification de propriété. Si le contrôle prend en charge la propriété IsOffscreen , il doit prendre en charge cet événement.
UIA_SelectionItem_ElementRemovedFromSelectionEventId Si le contrôle prend en charge le modèle de contrôle SelectionItem , il doit prendre en charge cet événement.
UIA_SelectionItem_ElementSelectedEventId Si le contrôle prend en charge le modèle de contrôle SelectionItem , il doit prendre en charge cet événement.
UIA_StructureChangedEventId

 

Notes

Une case d’option représente une seule option sélectionnable parmi un groupe de cases d’option d’homologues. Dans l’idéal, les cases d’option doivent avoir un élément de regroupement qui clarifie les limites des cases d’option homologues. Toutefois, souvent, la limite est impliquée par la structure d’élément d’interface utilisateur. Par exemple, un menu peut contenir un ensemble de cases d’option consécutives au lieu d’éléments de menu, ou un ensemble de cases d’option qui se produisent après une étiquette de groupe, mais avant un élément actionnable tel que le bouton.

Conceptuel

Vue d'ensemble des types de contrôle UI Automation

Vue d'ensemble d'UI Automation