Type de contrôle d’image

  • Article

Cette rubrique fournit des informations sur la prise en charge de Microsoft UI Automation pour le type de contrôle Image.

Les contrôles image utilisés comme icônes, graphiques d’information et graphiques prennent en charge le type de contrôle Image . Les contrôles utilisés comme images d’arrière-plan ou de filigrane ne prennent pas en charge le type de contrôle Image .

Les sections suivantes définissent les UI Automation l’arborescence, les propriétés, les modèles de contrôle et les événements requis pour le type de contrôle Image. Les exigences UI Automation s’appliquent à tous les contrôles d’image 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 UI Automation qui se rapporte aux contrôles d’image 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 de contrôle Vue de contenu
Image Image (Dépend si l’image contient des informations, en fonction de la valeur de la propriété Automation Element Property Identifiers )

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 d’image. 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. Rectangle externe qui contient l’ensemble du contrôle.
UIA_ClickablePointPropertyId Consultez les remarques. Le point cliquable du contrôle d’image doit être un point dans le rectangle englobant du contrôle d’image.
UIA_ControlTypePropertyId Image
UIA_HelpTextPropertyId Consultez les remarques. La propriété HelpText expose une chaîne localisée qui décrit l’apparence visuelle réelle du contrôle ou d’autres informations d’info-bulle associées à l’image. Cette propriété doit être prise en charge lorsqu’une description longue est nécessaire pour transmettre plus d’informations sur le contrôle d’image (par exemple, si l’image est un graphique ou un diagramme complexe). Cette propriété est mappée à la balise HTML LongDesc et à la balise Desc SVG (Scalable Vector Graphics). Les développeurs qui travaillent avec des contrôles Image doivent prendre en charge une propriété pour pouvoir définir la description visuelle sur le contrôle. Cette propriété doit être mappée au UI Automation propriété VisualDescription.
UIA_IsContentElementPropertyId Consultez les remarques. Le contrôle d’image doit être inclus dans l’affichage du contenu de l’arborescence UI Automation lorsqu’il contient des informations significatives qui n’ont pas encore été exposées à l’utilisateur final.
UIA_IsControlElementPropertyId true Le contrôle d’image est toujours inclus dans l’affichage de contrôle de l’arborescence UI Automation.
UIA_IsKeyboardFocusablePropertyId Consultez les remarques. Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
UIA_ItemStatusPropertyId Consultez les remarques. Si le contrôle Image représente des informations d’état sur un élément particulier à l’écran, le contrôle doit être contenu dans l’élément. Lorsque l’image est contenue dans un élément, l’élément doit prendre en charge la propriété status et déclencher des notifications appropriées lorsque le status change. Si une image correspond à un contrôle autonome et transmet un état, la propriété Status doit être prise en charge.
UIA_LabeledByPropertyId Consultez les remarques. S’il existe une étiquette de texte statique, cette propriété doit exposer une référence à ce contrôle.
UIA_LocalizedControlTypePropertyId Consultez les remarques. Chaîne localisée correspondant au type de contrôle Image . La valeur par défaut est « image » pour en-US ou English (États-Unis).
UIA_NamePropertyId Consultez les remarques. La propriété Name doit être exposée pour tous les contrôles d’image qui contiennent des informations. Pour accéder par programme à ces informations, il convient de fournir un équivalent textuel du graphique. Si le contrôle d’image est purement décoratif, il doit uniquement apparaître dans la vue de contrôle de l’arborescence UI Automation et n’est pas obligatoire pour avoir un nom (voir Remarques). Les infrastructures d’interface utilisateur doivent prendre en charge une propriété de texte de remplacement ou ALT sur les images qu’il est possible de définir dans leur infrastructure. Cette propriété est ensuite mappée à la propriété Name UI Automation.

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 d’image. Pour plus d’informations sur les modèles de contrôle, consultez UI Automation Control Patterns Overview.

Modèle de contrôle Support Notes
IGridItemProvider Dépend Le contrôle image prend en charge le modèle de contrôle GridItem si le contrôle se trouve dans un conteneur de grille.
IInvokeProvider Jamais Si le contrôle d’image est un objet cliquable, le contrôle doit prendre en charge un type de contrôle qui prend en charge le modèle de contrôle Invoke , tel que le type de contrôle Button . Pour un objet image qui contient plusieurs objets cliquables, l’élément (type de contrôle Image) peut héberger des liens enfants (type de contrôle Hyperlink) dans l’arborescence UI Automation.
ISelectionItemProvider Jamais Les contrôles image ne doivent pas prendre en charge le modèle de contrôle SelectionItem . Si les images font partie d’un conteneur sélectionnable, tel qu’un bouton contenant une icône d’image en tant que contenu, ce conteneur prend en charge le modèle, et non l’image dans.
ITableItemProvider Dépend Le contrôle image prend en charge le modèle de contrôle TableItem si le contrôle se trouve dans un conteneur qui a des contrôles d’en-tête.

Événements obligatoires

Le tableau suivant répertorie les événements UI Automation que les contrôles d’image 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_ItemStatusPropertyId’événement de modification de propriété. Si le contrôle prend en charge la propriété ItemStatus , il doit prendre en charge cet événement.
UIA_NamePropertyId événement de modification de propriété.
UIA_StructureChangedEventId

Notes

Le World Wide Web Consortium (W3C) définit une image décorative comme une image qui n’ajoute pas d’informations au contenu d’une page. Pour plus d’informations, consultez la rubrique W3C sur les images décoratives.

En ce qui concerne les UI Automation :

  • Si une image est purement décorative, n’est pas interactive et ne transmet aucune information, l’image :
    • Peut-être ou non dans l’arborescence UIA
    • Peut-être ou non dans la vue brute UIA
    • Ne doit pas se trouver dans la vue de contrôle UIA
    • Ne doit pas se trouver dans la vue de contenu
    • Peut-être ou ne pas avoir un nom
  • Si une image transmet des informations, mais qu’il existe un texte clairement associé qui fournit les mêmes informations (par exemple, un bouton de lecture qui contient un graphique triangle pointant vers la gauche avec le texte « lecture »), l’image est considérée comme décorative et l’image :
    • Doit être dans la vue brute
    • Doit se trouver dans la vue de contrôle
    • Ne doit pas se trouver dans la vue de contenu
    • Peut avoir ou non une valeur dans la propriété Name
    • Le texte qui transmet également la signification de l’image doit se trouver dans la vue de contenu
  • Si une image est informative et transmet des détails qui ne sont fournis par aucun texte associé, l’image :
    • Doit être dans la vue brute
    • Doit se trouver dans la vue de contrôle
    • Doit se trouver dans la vue de contenu
    • Doit avoir une valeur de nom qui décrit l’image et sa signification

Conceptuel