Partager via

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

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 le support UI Automation pour le type de contrôle StatusBar. 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 de propriété UI Automation et les modèles de contrôle.

Un contrôle de barre d’état affiche des informations sur un objet affiché dans une fenêtre d’une application, le composant de l’objet ou des informations contextuelles qui concernent l’opération de cet objet au sein de votre application.

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

Arborescence UI Automation obligatoire

Le tableau suivant illustre la vue de contrôle et la vue de contenu de l’arborescence UI Automation qui se rapporte aux contrôles de barre d’état 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 d'état

- Modifier (0 ou plus)
- Barre de progression (0 ou plusieurs)
- Image (0 ou plusieurs)
- Bouton (0 ou plusieurs)		 Barre d'état

- Modifier (0 ou plus)
- ProgressBar (0 ou plusieurs)
- Image (0 ou plusieurs)
- Bouton (0 ou plusieurs)

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. Le rectangle englobant d’une barre d’état doit englober tous les contrôles contenus dans celui-ci.
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 d’état n’a pas besoin d’un nom, sauf si plusieurs d’entre eux sont utilisés dans une application. Dans ce cas, distinguez chaque barre avec des noms tels que « État Internet » ou « État de l’application ».
LabeledByProperty Null Le contrôle de la barre d’état n’a généralement pas d’étiquette.
ControlTypeProperty Barre d'état Cette valeur est la même pour toutes les infrastructures d’interface utilisateur.
LocalizedControlTypeProperty « barre d’état » Chaîne localisée correspondant au type de contrôle StatusBar.
IsContentElementProperty Vrai La barre d'état contient toujours du contenu.
IsControlElementProperty Vrai Le contrôle de barre d’état est toujours un contrôle.
IsOffscreenProperty Dépend Un contrôle de barre d’état retourne True pour cette propriété s’il n’est pas visible à l’écran.
OrientationProperty Dépend Valeur de l’orientation du contrôle : horizontale ou verticale.
IsKeyboardFocusableProperty Faux Sans objet
AcceleratorKeyProperty Null Les barres d’état n’ont pas de touches d’accélérateur.

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 barre d’état. 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 Soutien Remarques
IGridProvider Optionnel Les contrôles de barre d’état doivent prendre en charge le modèle de contrôle Grid afin que les éléments individuels puissent être surveillés et facilement référencés pour obtenir des informations.

É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 d’état. 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
AutomationFocusChangedEvent Obligatoire Aucun
StructureChangedEvent Obligatoire Aucun

Voir aussi