Type de contrôle StatusBar
Cette rubrique fournit des informations sur la prise en charge de Microsoft UI Automation pour le type de contrôle StatusBar.
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 les UI Automation arborescence, les propriétés, les modèles de contrôle et les événements requis pour le type de contrôle StatusBar. Les exigences UI Automation s’appliquent à tous les contrôles de barre status où l’infrastructure/plateforme d’interface utilisateur intègre UI Automation prise en charge des types de contrôles et des modèles de contrôle.
Cette rubrique contient les sections suivantes.
- Structure d’arborescence classique
- Propriétés pertinentes
- Modèles de contrôle requis
- Événements obligatoires
- Remarques
- Rubriques connexes
Structure d’arborescence classique
Le tableau suivant illustre une vue de contrôle et de contenu typique de l’arborescence de UI Automation qui se rapporte aux contrôles de barre status 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.
| Affichage de contrôle | Affichage de contenu |
|---|---|
|
|
Propriétés pertinentes
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 status. Pour plus d’informations sur les propriétés UI Automation, consultez Récupération des propriétés à partir d’éléments UI Automation.
| Propriété UI Automation | Valeur | Notes |
|---|---|---|
| UIA_AutomationIdPropertyId | Consultez les remarques. | La valeur de cette propriété doit être unique parmi tous les éléments homologues dans la vue brute de l’arborescence UI Automation. |
| UIA_BoundingRectanglePropertyId | Consultez les remarques. | Le rectangle englobant d’une barre d’état doit englober tous les contrôles qu’il contient. |
| UIA_ClickablePointPropertyId | Consultez les remarques. | Pris en charge s’il existe un rectangle englobant. S’il existe des zones dans le rectangle englobant qui ne sont pas cliquables et que l’élément effectue des tests d’accès spécialisés, remplacez ce paramètre et fournissez un point cliquable. |
| UIA_ControlTypePropertyId | StatusBar | |
| UIA_IsContentElementPropertyId | true | Le contrôle de barre de status est toujours inclus dans la vue de contenu de l’arborescence UI Automation. |
| UIA_IsControlElementPropertyId | true | Le contrôle de barre de status est toujours inclus dans la vue de contrôle de l’arborescence UI Automation. |
| UIA_IsKeyboardFocusablePropertyId | Dépend | Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété. |
| UIA_IsOffscreenPropertyId | Dépend | Si un contrôle de barre de status n’est actuellement pas visible, il retourne TRUE pour cette propriété. |
| UIA_LabeledByPropertyId | NULL | Le contrôle de barre de status n’a généralement pas d’étiquette. |
| UIA_LocalizedControlTypePropertyId | Consultez les remarques. | Chaîne localisée correspondant au type de contrôle StatusBar . La valeur par défaut est « barre status » pour en-US ou Anglais (États-Unis). |
| UIA_NamePropertyId | 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, distinguez chaque barre avec des noms tels que « État Internet » ou « État de l’application ». |
| UIA_OrientationPropertyId | Dépend | Valeur indiquant l’orientation du contrôle : horizontale ou verticale. |
Modèles de contrôle requis
Le tableau suivant répertorie les modèles de contrôle UI Automation qui doivent être pris en charge pour les contrôles de barre status. 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 afin que des éléments individuels puissent être surveillés et facilement référencés pour obtenir des informations. |
Événements obligatoires
Le tableau suivant répertorie les événements UI Automation que status contrôles de barre doivent prendre en charge. Pour plus d’informations sur les événements, consultez UI Automation Events Overview.
| Événement UI Automation | Notes |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId’événement de modification de propriété. | |
| UIA_IsEnabledPropertyId événement de modification de propriété. | Si le contrôle prend en charge la propriété IsEnabled , il doit prendre en charge cet événement. |
| UIA_IsOffscreenPropertyId événement de modification de propriété. | Si le contrôle prend en charge la propriété IsOffscreen , il doit prendre en charge cet événement. |
| UIA_StructureChangedEventId |
Notes
Nous vous recommandons d’utiliser des contrôles de modification en tant qu’éléments de grille enfants dans une barre de status. L’utilisation de contrôles d’édition facilite l’association de l’objectif du champ status à sa valeur à l’aide du nom de l’élément et de la propriété value. Étant donné que les contrôles de texte ne doivent pas prendre en charge le modèle de contrôle Value , ils ne doivent pas être utilisés comme éléments de grille enfants.
Rubriques connexes