Partager via

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 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 où l’infrastructure/la plateforme d’interface utilisateur intègre la prise en charge d’UI Automation pour les types de contrôles et les modèles de contrôle.

Cette rubrique contient les sections suivantes.

Structure d’arborescence classique

Le tableau suivant illustre un contrôle et une vue de contenu typiques 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
  • StatusBar
    • Modifier (0 ou plus)
    • ProgressBar (0 ou plusieurs)
    • Image (0 ou plusieurs)
    • Bouton (0 ou plusieurs)
  • StatusBar
    • Modifier (0 ou plus)
    • ProgressBar (0 ou plusieurs)
    • Image (0 ou plusieurs)
    • Bouton (0 ou plusieurs)

 

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 d’état. Pour plus d’informations sur les propriétés UI Automation, consultez Récupération des propriétés à partir d’UI Automation Elements.

UI Automation, propriété Valeur Notes
UIA_AutomationIdPropertyId Consultez les notes. 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 notes. Le rectangle englobant d’une barre d’état doit englober tous les contrôles contenus dans celui-ci.
UIA_ClickablePointPropertyId Consultez les notes. Prise 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 de positionnement spécialisés, remplacez-le et fournissez un point cliquable.
UIA_ControlTypePropertyId StatusBar
UIA_IsContentElementPropertyId VRAI Le contrôle de barre d’état est toujours inclus dans la vue de contenu de l’arborescence UI Automation.
UIA_IsControlElementPropertyId VRAI Le contrôle de barre d’état est toujours inclus dans la vue 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 d’état n’est actuellement pas visible, il retourne TRUE pour cette propriété.
UIA_LabeledByPropertyId ZÉRO Le contrôle de barre d’état n’a généralement pas d’étiquette.
UIA_LocalizedControlTypePropertyId Consultez les notes. Chaîne localisée correspondant au type de contrôle StatusBar. La valeur par défaut est « barre d’état » pour en-US ou l’anglais (États-Unis).
UIA_NamePropertyId 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 ».
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 requis pour être pris en charge pour 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 Notes
IGridProvider Optionnel Les contrôles de barre d’état doivent prendre en charge le modèle de contrôle grille afin que les é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 requis pour prendre en charge 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 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

 

Remarques

Nous vous recommandons d’utiliser les contrôles de modification en tant qu’éléments de grille enfants dans une barre d’état. L’utilisation de contrôles d’édition facilite l’association de l’objectif du champ d’état à 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 valeur, ils ne doivent pas être utilisés comme éléments de grille enfant.

conceptuelle

Vue d’ensemble des types de contrôle UI Automation

Vue d’ensemble UI Automation

 

 

  • Last updated on