Type de contrôle Spinner

  • Article

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

Les contrôles compteur sont utilisés pour effectuer une sélection parmi un domaine d’éléments ou une plage de nombres.

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

Cette rubrique contient les sections suivantes.

Arborescence standard

Le tableau suivant illustre une vue de contrôle et de contenu standard de l’arborescence UI Automation qui se rapportent aux contrôles de rotation lorsqu’ils prennent en charge les modèles de contrôle RangeValue et Selection, 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.

Modèle de contrôle RangeValue

Affichage de contrôle Affichage de contenu
  • Spinner
    • Edit (0 ou 1)
    • Button (2)
  • Spinner

 

Selection (modèle de contrôle)

Affichage de contrôle Affichage de contenu
  • Spinner
    • Edit (0 ou 1)
    • Button (2)
    • Élément de liste (0 ou plusieurs)
  • Spinner
    • ListItem (0 ou plus)

 

Pour vous assurer que les deux boutons de la sous-arborescence d’affichage de contrôle peuvent être distingués par des outils de test automatisés, affectez la valeur ScrollAmount_SmallIncrement ou ScrollAmount_SmallDecrement à la propriété AutomationId le cas échéant. Pour certaines implémentations, le contrôle d’édition associé peut être un homologue du contrôle spinner.

Propriétés pertinentes

Le tableau suivant liste les propriétés UI Automation dont la valeur ou la définition est particulièrement pertinente pour les contrôles de compteur. Pour plus d’informations sur UI Automation propriétés, consultez Récupération de 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 interactif du contrôle compteur donne le focus à la partie d’édition du contrôle.
UIA_ControlTypePropertyId Spinner Cette valeur est la même pour toutes les infrastructures.
UIA_IsContentElementPropertyId true Le contrôle compteur doit toujours être du contenu.
UIA_IsControlElementPropertyId true Le contrôle spinner doit toujours être un contrôle.
UIA_IsKeyboardFocusablePropertyId Consultez les remarques. Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété. Un contrôle de rotation prend rarement le focus, mais lorsqu’il le fait, le focus doit rester sur le contrôle de rotation lui-même, et non sur les boutons enfants. L’utilisateur doit être en mesure d’effectuer toutes les actions de défilement à l’aide des touches Flèche haut et Flèche bas.
UIA_LabeledByPropertyId Consultez les remarques. Les contrôles compteur ont une étiquette de texte statique.
UIA_LocalizedControlTypePropertyId Consultez les remarques. Chaîne localisée correspondant au type de contrôle Spinner . La valeur par défaut est « spinner » pour en-US ou english (États-Unis).
UIA_NamePropertyId Consultez les remarques. Le contrôle compteur tire généralement son nom d’une étiquette de texte statique.

 

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 rotation. 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
IRangeValueProvider Dépend Les contrôles spinner qui s’étendent sur une plage numérique peuvent prendre en charge le modèle de contrôle RangeValue .
ISelectionProvider Dépend Les contrôles spinner qui ont une liste d’éléments à sélectionner doivent prendre en charge le modèle de contrôle Sélection .
CanSelectMultiple FAUX Les contrôles compteur sont toujours des conteneurs à sélection unique.
IValueProvider Dépend Les contrôles spinner qui s’étendent sur un ensemble d’options ou de nombres peuvent prendre en charge le modèle de contrôle Value .

 

Événements obligatoires

Le tableau suivant répertorie les événements UI Automation que les contrôles spinner 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_RangeValueValuePropertyId’événement de modification de propriété. Si le contrôle prend en charge le modèle de contrôle RangeValue , il doit prendre en charge cet événement.
UIA_Selection_InvalidatedEventId’événement de modification de propriété. Si le contrôle prend en charge le modèle de contrôle Sélection , il doit prendre en charge cet événement.
UIA_StructureChangedEventId
UIA_ValueValuePropertyId événement de modification de propriété. Si le contrôle prend en charge le modèle de contrôle Value , il doit prendre en charge cet événement.

 

Conceptuel

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

Vue d'ensemble d'UI Automation