Partager via

Type de contrôle RadioButton

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 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.

Note

Une autre généralisation des contrôles pour les boutons où un seul dans 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 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 bouton dans lesquels l’infrastructure/la plateforme d’interface utilisateur intègre la prise en charge d’UI Automation pour les types de contrôles et les modèles de contrôle.

Cette rubrique contient les sections suivantes.

Structure d’arborescence classique

Le tableau suivant illustre un contrôle et une vue de contenu typiques 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 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 (par exemple, 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’UI Automation Elements.

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

 

Modèles de contrôle requis

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.

Control Pattern/Pattern, propriété Prise en charge/valeur Notes
ISelectionItemProvider Obligatoire Tous les contrôles de case d’option doivent prendre en charge le modèle de contrôle SelectionItem pour pouvoir être sélectionnés.
SelectionContainer Consultez les notes. La propriété SelectionContainer doit toujours être terminée afin qu’un client UI Automation puisse déterminer les autres cases d’option dans un contexte spécifique. 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 parcourir son état une fois qu’elle a été définie. Le bascule modèle de contrôle 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 requis pour prendre en charge les contrôles de bouton. Pour plus d’informations sur les événements, consultez vue d’ensemble des événements UI Automation.

É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

 

Remarques

Une case d’option représente une option sélectionnable unique parmi un groupe de cases d’option 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, la limite est souvent implicite par la structure d’élément de l’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.

conceptuelle

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

Vue d’ensemble UI Automation

 

 

  • Last updated on