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

Remarque

Cette documentation est destinée aux développeurs .NET Framework qui souhaitent 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.

Cette rubrique fournit des informations sur la prise en charge d’UI Automation pour le type de contrôle Thumb. Dans UI Automation, un type de contrôle est un ensemble de conditions qu’un contrôle doit respecter pour utiliser la ControlTypeProperty propriété. Les conditions incluent des instructions spécifiques pour la structure d’arborescence UI Automation, les valeurs des propriétés UI Automation et les modèles de contrôle.

Les contrôles de pouce fournissent les fonctionnalités qui permettent de déplacer un contrôle, par exemple un bouton de barre de défilement, ou de le redimensionner, comme avec un outil de redimensionnement de fenêtre. Les contrôles pouce peuvent également être implémentés en tant que bordures mobiles de volets. Notez qu’il ne fournit pas de fonctionnalité de glisser-déplacer. Les contrôles pouce peuvent recevoir le focus de la souris, mais généralement pas le focus clavier. Le développeur du contrôle doit implémenter le contrôle afin qu’il agisse correctement (peut être déplacé ou redimensionné).

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 Thumb. Les exigences UI Automation s’appliquent à tous les contrôles de pouce, que Windows Presentation Foundation (WPF), Win32 ou Windows Forms.

Arborescence UI Automation obligatoire

Le tableau suivant illustre l’affichage de contrôle et l’affichage de contenu de l’arborescence UI Automation qui se rapporte aux contrôles pouce 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 de contrôle Affichage de contenu
Pouce - Non applicable

Les contrôles pouce n’apparaissent jamais en mode Contenu, car ils existent uniquement pour être manipulés avec une souris. Leurs fonctionnalités sont exposées par le biais d'un autre modèle de contrôle, tel que Scroll Pattern, Transform Pattern ou RangeValue Pattern, pris en charge sur le conteneur Thumb.

Propriétés UI Automation obligatoires

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 pouce. 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 Consultez les notes. La valeur de cette propriété doit être unique sur tous les contrôles d’une application.
BoundingRectangleProperty Consultez les notes. Rectangle le plus externe qui contient l’ensemble du contrôle.
ClickablePointProperty Consultez les notes. N’importe quel point dans la zone cliente visible du contrôle curseur de position.
IsKeyboardFocusableProperty Consultez les notes. Si le contrôle peut recevoir le focus du clavier, il doit supporter cette propriété.
NameProperty Null Le contrôle Thumb n’est pas disponible dans la vue du contenu de l’arborescence de l’automatisation de l’interface utilisateur, il n'a donc pas besoin de nom.
LabeledByProperty Null Les contrôles Pouce n’ont jamais d’étiquette.
ControlTypeProperty Pouce Cette valeur est la même pour toutes les infrastructures d’interface utilisateur.
LocalizedControlTypeProperty "curseur de position" Chaîne localisée correspondant au type de contrôle Thumb.
IsContentElementProperty Faux Le contrôle curseur de position ne représente jamais du contenu.
IsControlElementProperty Vrai Le contrôle curseur de position doit toujours être un contrôle.

Modèles de contrôle UI Automation obligatoires

Le tableau suivant répertorie les modèles de contrôle UI Automation requis pour être pris en charge par les contrôles de pouce. 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
ITransformProvider Obligatoire Permet au contrôle de pouce d’être déplacé sur l’écran.

Événements UI Automation obligatoires

Le tableau suivant répertorie les événements UI Automation requis pour être pris en charge par tous les contrôles de pouce. Pour plus d’informations sur les événements, consultez Vue d’ensemble des événements UI Automation.

Événement d'automatisation de l'interface utilisateur Soutien Remarques
Événement de modification de la propriété BoundingRectangleProperty. Obligatoire Aucun
Événement de modification de la propriété IsOffscreenProperty. Obligatoire Aucun
Événement de modification de la propriété IsEnabledProperty. Obligatoire Aucun
AutomationFocusChangedEvent Obligatoire Aucun
StructureChangedEvent Obligatoire Aucun

Voir aussi

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