Prise en charge d'UI Automation pour le type de contrôle StatusBar
Notes
Cette documentation s’adresse 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 dernières informations 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 StatusBar. Dans UI Automation, un type de contrôle est un ensemble de conditions qu’un contrôle doit respecter pour pouvoir utiliser la propriété ControlTypeProperty. Les conditions incluent des instructions spécifiques pour la structure d’arborescence, les valeurs de propriété et les modèles de contrôle UI Automation.
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 relatives au fonctionnement de cet objet dans 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 nécessaires pour le type de contrôle StatusBar. Les exigences UI Automation s’appliquent à tous les contrôles de barre d’état, que ce soit Windows Presentation Foundation (WPF), Win32 ou Windows Forms.
Arborescence UI Automation obligatoire
Le tableau suivant représente l’affichage de contrôle et l’affichage du contenu de l’arborescence UI Automation concernant les contrôles de barre d’état. En outre, il décrit ce que peut contenir 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 de contenu |
|---|---|
| StatusBar - Edit (0 ou plus) - Progress Bar (0 ou plusieurs) - Image (0 ou plusieurs) - Button (0 ou plusieurs) |
StatusBar - Edit (0 ou plus) - ProgressBar (0 ou plusieurs) - Image (0 ou plusieurs) - Button (0 ou plusieurs) |
Propriétés UI Automation obligatoires
Le tableau suivant liste 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 | Notes |
|---|---|---|
| AutomationIdProperty | Consultez les remarques. | La valeur de cette propriété doit être unique dans tous les contrôles d’une application. |
| BoundingRectangleProperty | Consultez les remarques. | Le rectangle englobant d’une barre d’état doit englober tous les contrôles qu’il contient. |
| ClickablePointProperty | Consultez les remarques. | Pris 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 remarques. | Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété. |
| NameProperty | Consultez les remarques. | Le contrôle de barre d’état n’a pas besoin d’un nom sauf si plusieurs contrôles sont utilisés dans une application. Dans ce cas, différenciez les barres avec des noms tels que « État Internet » ou « État de l’application ». |
| LabeledByProperty | Null |
Le contrôle de barre d’état n’a généralement pas d’étiquette. |
| ControlTypeProperty | StatusBar | Cette valeur est identique pour toutes les infrastructures d’interface utilisateur. |
| LocalizedControlTypeProperty | « barre d’état » | Chaîne localisée correspondant au type de contrôle StatusBar. |
| IsContentElementProperty | True | Le contrôle de barre d’état contient toujours du contenu. |
| IsControlElementProperty | True | 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 | False | Non applicable |
| AcceleratorKeyProperty | Null |
Les barres d’état n’ont pas de touches accélérateur. |
Modèles de contrôle UI Automation obligatoires
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 d’état. Pour plus d’informations sur les modèles de contrôle, consultez UI Automation Control Patterns Overview.
| Modèle de contrôle | Support | Notes |
|---|---|---|
| IGridProvider | Facultatif | Les contrôles de barre d’état doivent prendre en charge le modèle de contrôle Grid pour que les éléments individuels puissent être surveillés et facilement référencés à titre d’information. |
Événements UI Automation obligatoires
Le tableau suivant répertorie les événements UI Automation qui doivent être pris en charge par tous les contrôles de barre d’état. Pour plus d’informations sur les événements, consultez UI Automation Events Overview.
| Événement UI Automation | Support | Notes |
|---|---|---|
| Événement de modification de propriétéBoundingRectangleProperty | Obligatoire | None |
| Événement de modification de propriétéIsOffscreenProperty | Obligatoire | None |
| Événement de modification de propriétéIsEnabledProperty | Obligatoire | None |
| AutomationFocusChangedEvent | Obligatoire | None |
| StructureChangedEvent | Obligatoire | None |