Partager via

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

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 ProgressBar. 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, les modèles de contrôle et les événements UI Automation.

Les contrôles de barre de progression sont un exemple de contrôles qui implémentent le type de contrôle ProgressBar. Les contrôles de barre de progression sont utilisés pour indiquer la progression d’une longue opération. Le contrôle se compose d’un rectangle qui est progressivement rempli avec la couleur de surbrillance système à mesure qu’une opération progresse.

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 ProgressBar. Les exigences UI Automation s’appliquent à tous les contrôles de liste, 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 de barre de progression 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
Barre de progression Barre de progression

Les contrôles de barre de progression n’ont pas d’enfants dans la vue contrôle ou contenu de l’arborescence UI Automation.

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 de barre de progression. 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. Prise en charge s’il existe un rectangle englobant. Si les points du rectangle englobant ne sont pas tous interactifs et que vous effectuez un test de positionnement spécialisé, vous devez remplacer et fournir un point interactif.
IsKeyboardFocusableProperty Consultez les notes. Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
NameProperty Consultez les notes. Le contrôle de barre de progression obtient généralement son nom à partir d’une étiquette de texte statique. S’il n’existe pas d’étiquette de texte statique, le développeur de l’application doit exposer une valeur pour la Name propriété.
LabeledByProperty Consultez les notes. S’il existe une étiquette de texte statique, cette propriété doit exposer une référence à ce contrôle.
ControlTypeProperty Barre de progression Cette valeur est la même pour toutes les infrastructures d’interface utilisateur.
LocalizedControlTypeProperty « barre de progression » Chaîne localisée correspondant au type de contrôle ProgressBar.
IsContentElementProperty Vrai Le contrôle de barre de progression est toujours inclus dans la vue de contenu de l’arborescence UI Automation.
IsControlElementProperty Vrai Le contrôle de barre de progression est toujours inclus dans la vue de contrôle de l’arborescence UI Automation.

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

Le tableau suivant répertorie les modèles de contrôle UI Automation requis pour être pris en charge par les contrôles de barre de progression. 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 Remarques
IValueProvider Dépend Les contrôles de barre de progression qui fournissent une indication textuelle de la progression doivent incorporer IValueProvider.
IsReadOnly Vrai La valeur de cette propriété est toujours True.
Value Consultez les notes. Cette propriété expose la progression textuelle d’un contrôle de barre de progression.
IRangeValueProvider Dépend Les contrôles de barre de progression qui prennent une plage numérique doivent implémenter IRangeValueProvider
Minimum 0,0 La valeur de cette propriété est la plus petite sur laquelle le contrôle peut être défini.
Maximum 100.0 La valeur de cette propriété est la plus grande valeur sur laquelle le contrôle peut être défini.
SmallChange NAN Cette propriété n’est pas obligatoire, car les contrôles de barre de progression sont en lecture seule.
LargeChange NAN Cette propriété n’est pas obligatoire, car les contrôles de barre de progression sont en lecture seule.

É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 barre de progression. Pour plus d’informations sur les événements, consultez vue d’ensemble des événements UI Automation.

Événement UI Automation 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
Événement de modification de la propriété NameProperty. Obligatoire Aucun
Événement de modification de la propriété ValueProperty. Dépend Aucun
AutomationFocusChangedEvent Obligatoire Aucun
StructureChangedEvent Obligatoire Aucun

Voir aussi