Type de contrôle d’image
Cette rubrique fournit des informations sur la prise en charge de Microsoft UI Automation pour le type de contrôle image.
Les contrôles d’image utilisés en tant qu’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 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 Image. Les exigences UI Automation s’appliquent à tous les contrôles d’image où l’infrastructure/la plateforme d’interface utilisateur intègre la prise en charge d’UI Automation pour les types de contrôle et les 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
- rubriques connexes
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 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 contrôle | Affichage du contenu |
|---|---|
| Image | Image (Détermine si l’image contient des informations, en fonction de la valeur des identificateurs de propriété d’élément Automation propriété) |
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’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. | Rectangle le plus externe qui contient l’ensemble du contrôle. |
| UIA_ClickablePointPropertyId | Consultez les notes. | 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 notes. | 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 SVG (Scalable Vector Graphics) Desc. Les développeurs qui travaillent avec des contrôles d’image doivent prendre en charge une propriété pour permettre à la description visuelle d’être définie sur le contrôle. Cette propriété doit être mappée à la propriété ui Automation VisualDescription. |
| UIA_IsContentElementPropertyId | Consultez les notes. | Le contrôle d’image doit être inclus dans la vue de contenu de l’arborescence UI Automation lorsqu’il contient des informations significatives qui ne sont pas déjà exposées à l’utilisateur final. |
| UIA_IsControlElementPropertyId | VRAI | Le contrôle d’image est toujours inclus dans la vue de contrôle de l’arborescence UI Automation. |
| UIA_IsKeyboardFocusablePropertyId | Consultez les notes. | Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété. |
| UIA_ItemStatusPropertyId | Consultez les notes. | 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é d’état et déclencher les notifications appropriées lorsque l’état change. Si une image est un contrôle autonome et qu’elle transmet l’état de cette propriété doit être prise en charge. |
| UIA_LabeledByPropertyId | Consultez les notes. | S’il existe une étiquette de texte statique, cette propriété doit exposer une référence à ce contrôle. |
| UIA_LocalizedControlTypePropertyId | Consultez les notes. | Chaîne localisée correspondant au type de contrôle Image. La valeur par défaut est « image » pour en-US ou l’anglais (États-Unis). |
| UIA_NamePropertyId | Consultez les notes. | La propriété Name doit être exposée pour tous les contrôles d’image qui contiennent des informations. L’accès par programmation à ces informations nécessite qu’un équivalent textuel du graphique soit fourni. Si le contrôle d’image est purement décoratif, il doit uniquement apparaître dans l’affichage contrôle de l’arborescence UI Automation et n’est pas requis pour avoir un nom (voir Remarques). Les infrastructures d’interface utilisateur doivent prendre en charge une propriété alt ou de texte de remplacement sur des images qui peuvent être définies à partir de leur infrastructure. Cette propriété est ensuite mappées à la propriété UI Automation Name. |
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 d’image. 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 |
|---|---|---|
| IGridItemProvider | Dépend | Le contrôle d’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 (Lien hypertexte type de contrôle) dans l’arborescence UI Automation. |
| ISelectionItemProvider | Jamais | Les contrôles d’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 qui a une icône d’image en tant que contenu, ce conteneur prend en charge le modèle, et non l’image. |
| 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 nécessaires à la prise en charge des contrôles d’image. 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_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 |
Remarques
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 images décoratives.
En ce qui concerne 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 être dans la vue de contrôle UIA
- Ne doit pas se trouver dans la vue de contenu
- Peut-être ou ne pas avoir de 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 en triangle pointant vers la gauche, ainsi que le texte « lire »), l’image est considérée comme décorative et l’image :
- Doit être en mode brut
- Doit se trouver dans la vue de contrôle
- Ne doit pas se trouver dans la vue de contenu
- Peut ou non avoir 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 pas fournis par un texte associé, l’image :
- Doit être en mode brut
- 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
Rubriques connexes
Conceptuel
- Vue d’ensemble des types de contrôle UI Automation
- Vue d’ensemble UI Automation