Prise en charge d'UI Automation pour le type de contrôle Spinner

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 Spinner. Dans UI Automation, un type de contrôle est un ensemble de conditions qu'un contrôle doit respecter afin d'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 .

Les contrôles Spinner sont utilisés pour effectuer une sélection dans un domaine d'éléments ou une plage de nombres.

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 Spinner. Les spécifications UI Automation s'appliquent à tous les contrôles spinner, 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 et propriétés 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 applicables aux contrôles Spinner lorsqu'ils prennent en charge les modèles de contrôle Range Value, Value et Selection. Il décrit également les éléments pouvant être inclus dans chaque affichage. Pour plus d'informations sur l'arborescence UI Automation, consultez Vue d'ensemble de l'arborescence UI Automation.

Modèle de contrôle Range Value ou Value

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

Modèle de contrôle Selection

Affichage de contrôle	Affichage du contenu
Spinner Edit (0 ou 1) Button (2) List Item (0 ou plus)	Spinner ListItem (0 ou plus)

Pour garantir que les deux boutons du sous-arbre de l'affichage de contrôle puissent être distingués par les outils de tests automatisés, assignez SmallIncrement ou SmallDecrementAutomationId comme il convient. Pour certaines implémentations, le contrôle Edit associé peut être un homologue du contrôle Spinner.

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 les contrôles Spinner. 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	Consulter les remarques.	La valeur de cette propriété doit être unique dans tous les contrôles d'une application.
BoundingRectangleProperty	Consulter les remarques.	Le rectangle le plus éloigné qui contient l'ensemble du contrôle.
ClickablePointProperty	Consulter les remarques.	Le point interactif du contrôle Spinner donne le focus à la partie d'édition du contrôle.
IsKeyboardFocusableProperty	Consulter les remarques.	Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
NameProperty	Consulter les remarques.	Le nom du contrôle Spinner correspond en général à une étiquette de texte statique.
LabeledByProperty	Consulter les remarques.	Les contrôles Spinner ont une étiquette de texte statique.
ControlTypeProperty	Spinner	Cette valeur est la même pour toutes les infrastructures d'interface utilisateur.
LocalizedControlTypeProperty	"spinner"	Chaîne localisée correspondant au type de contrôle Spinner.
IsContentElementProperty	True	Le contrôle Spinner doit toujours être du contenu.
IsControlElementProperty	True	Le contrôle Spinner doit toujours être un contrôle.

Modèles de contrôle et propriétés UI Automation requis

Le tableau suivant répertorie les modèles de contrôle UI Automation qui doivent être pris en charge par les contrôles Spinner. 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	Prise en charge / Valeur	Remarques
ISelectionProvider	Selon le cas	Les contrôles Spinner disposant d'une liste d'éléments à sélectionner doivent prendre en charge ce modèle.
CanSelectMultiple	False	Les contrôles Spinner sont toujours des conteneurs à sélection unique.
IRangeValueProvider	Selon le cas	Les contrôles Spinner qui couvrent une plage numérique peuvent prendre en charge ce modèle.
IValueProvider	Selon le cas	Les contrôles Spinner qui couvrent un jeu discret d'options ou de nombres peuvent prendre en charge ce modèle.

É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 spinner. 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
InvalidatedEvent	Selon le cas	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
Événement de modification de propriété ValueProperty.	Selon le cas	Aucun
Événement de modification de propriété ValueProperty.	Selon le cas	Aucun
AutomationFocusChangedEvent	Obligatoire	Aucun
StructureChangedEvent	Obligatoire	Aucun

Voir aussi

Référence

Spinner

Concepts

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

Vue d'ensemble d'UI Automation