Prise en charge d'UI Automation pour le type de contrôle ProgressBar
.gif "Remarque") 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 ProgressBar. 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, les modèles de contrôle et les événements d'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 se remplit progressivement dans la couleur de surbrillance système au fur et à mesure qu'une opération progresse.
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 ProgressBar. Les spécifications UI Automation s'appliquent à tous les contrôles de liste, 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 concernant les contrôles progress bar 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 |
|---|---|
ProgressBar |
ProgressBar |
Les contrôles de barre de progression n'ont aucun enfant dans l'affichage de contrôle et l'affichage du contenu de l'arborescence UI Automation.
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 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 |
|---|---|---|
Consulter les remarques. |
La valeur de cette propriété doit être unique dans tous les contrôles d'une application. |
|
Consulter les remarques. |
Le rectangle le plus éloigné qui contient l'ensemble du contrôle. |
|
Consulter les remarques. |
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 recherche spécialisé, vous devez substituer et fournir un point interactif. |
|
Consulter les remarques. |
Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété. |
|
Consulter les remarques. |
Le nom du contrôle de barre de progression correspond en général à une étiquette de texte statique. Si aucune étiquette de texte statique n'est présente, le développeur d'application doit exposer une valeur pour la propriété Name. |
|
Consulter les remarques. |
Si une étiquette de texte statique est présente, alors cette propriété doit exposer une référence à ce contrôle. |
|
ProgressBar |
Cette valeur est la même pour toutes les infrastructures d'interface utilisateur. |
|
"barre de progression" |
Chaîne localisée correspondant au type de contrôle ProgressBar. |
|
True |
Le contrôle de barre de progression est toujours inclus dans l'affichage du contenu de l'arborescence UI Automation. |
|
True |
Le contrôle de barre de progression est toujours inclus dans l'affichage de contrôle de l'arborescence UI Automation. |
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 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.
Modèle de contrôle / Propriété du modèle |
Prise en charge / Valeur |
Remarques |
|---|---|---|
Selon le cas |
Les contrôles de barre de progression qui donnent une indication textuelle de la progression doivent implémenter IValueProvider. |
|
True |
La valeur de cette propriété est toujours True. |
|
Consulter les remarques. |
Cette propriété expose la progression textuelle d'un contrôle de barre de progression. |
|
Selon le cas |
Les contrôles de barre de progression qui utilisent une plage numérique doivent implémenter IRangeValueProvider |
|
0.0 |
La valeur de cette propriété est la plus petite valeur que le contrôle peut avoir. |
|
100.0 |
La valeur de cette propriété est la plus grande valeur que le contrôle peut avoir. |
|
NaN |
Cette propriété n'est pas requise, car les contrôles de barre de progression sont en lecture seule. |
|
NaN |
Cette propriété n'est pas requise, car les contrôles de barre de progression sont en lecture seule. |
É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 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 |
Prise en charge |
Remarques |
|---|---|---|
É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é NameProperty. |
Obligatoire |
Aucun |
Événement de modification de propriété ValueProperty. |
Selon le cas |
Aucun |
Obligatoire |
Aucun |
|
Obligatoire |
Aucun |