Partager via


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

RemarqueRemarque

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 UI Automation pour le type de contrôle Slider. 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 types de contrôle.

Le contrôle Slider est un contrôle composite avec des boutons qui permettent à un utilisateur de définir, avec une souris, une plage numérique ou d'effectuer une sélection dans un jeu d'éléments.

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 Slider. Les spécifications UI Automation s'appliquent à tous les contrôles slider, 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 slider 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

Slider

  • Bouton (2 ou 4)

  • Thumb (1 seul)

  • List Item (0 ou plus)

Slider

  • List Item (0 ou plus)

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

La majorité des contrôles Slider doit déclencher NoClickablePointException, car l'ensemble du rectangle englobant du contrôle Slider est occupé par des contrôles enfants.

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.

En général, le nom du contrôle d'édition est généré à partir d'une étiquette de texte statique. S'il n'y a pas d'étiquette de texte statique, le développeur de l'application doit assigner une valeur de propriété pour Name. La propriété Name ne doit jamais contenir les contenus textuels du contrôle d'édition.

LabeledByProperty

Consulter les remarques.

Si le contrôle est associé à une étiquette de texte statique, cette propriété doit exposer une référence à ce contrôle. Si le contrôle de texte est un sous-composant d'un autre contrôle, aucune propriété LabeledBy ne sera définie.

ControlTypeProperty

Slider

Cette valeur est la même pour toutes les infrastructures d'UI.

LocalizedControlTypeProperty

"slider"

Chaîne localisée correspondant au type de contrôle Edit.

IsContentElementProperty

True

Le contrôle d'édition est toujours inclus dans l'affichage du contenu de l'arborescence UI Automation.

IsControlElementProperty

True

Le contrôle d'édition 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 slider. 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

Prise en charge

Remarques

ISelectionProvider

Selon le cas

Un curseur doit prendre en charge le modèle de contrôle Selection si le contenu représente une valeur comprise dans un jeu discret d'options. Lorsque le modèle de contrôle Selection est pris en charge, la sélection correspondante doit être exposée sous la forme d'un ou plusieurs éléments de liste enfants du curseur.

IRangeValueProvider

Selon le cas

Un curseur doit prendre en charge le modèle de contrôle RangeValue si le contenu peut avoir une valeur comprise dans une plage numérique.

IValueProvider

Selon le cas

Un curseur doit prendre en charge le modèle de contrôle Value si le contenu représente une valeur comprise dans un jeu discret d'options.

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

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

AutomationFocusChangedEvent

Obligatoire

Aucun

StructureChangedEvent

Obligatoire

Aucun

Voir aussi

Référence

Slider

Concepts

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

Vue d'ensemble d'UI Automation