Type de contrôle StatusBar

  • Article

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

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
  • StatusBar
    • Edition (0 ou plus)
    • ProgressBar (0 ou plusieurs)
    • Image (0 ou plusieurs)
    • Bouton (0 ou plusieurs)
  • StatusBar
    • Edition (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 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.

Conceptuel

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

Vue d'ensemble d'UI Automation