Prise en charge d'UI Automation pour le type de contrôle Image

Remarque

Cette documentation est destinée aux développeurs .NET Framework qui souhaitent utiliser les classes UI Automation managées définies dans l’espace de noms System.Windows.Automation. Pour obtenir les informations les plus récentes sur UI Automation, consultez API Windows Automation : UI Automation.

Cette rubrique fournit des informations sur la prise en charge d’UI Automation pour le type de contrôle Image. Dans UI Automation, un type de contrôle est un ensemble de conditions qu’un contrôle doit respecter pour utiliser la ControlTypeProperty propriété. Les conditions incluent des instructions spécifiques pour la structure d’arborescence UI Automation, les valeurs de propriété UI Automation et les modèles de contrôle.

Les contrôles d’image utilisés en tant qu’icônes, infographies et graphiques seront compatibles avec 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, que Windows Presentation Foundation (WPF), Win32 ou Windows Forms.

Arborescence UI Automation obligatoire

Le tableau suivant illustre la vue de contrôle et la vue de contenu 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 de contenu
Image	Image (Dépend si l’image contient des informations (en fonction de la valeur de IsContentElement la propriété))

Propriétés UI Automation obligatoires

Le tableau suivant répertorie les propriétés UI Automation dont la valeur ou la définition est particulièrement pertinente pour le type de contrôle Image. Pour plus d’informations sur les propriétés UI Automation, consultez Propriétés UI Automation pour les clients.

Propriété UI Automation	Valeur	Remarques
AutomationIdProperty	Consultez les notes.	La valeur de cette propriété doit être unique sur tous les contrôles d’une application.
BoundingRectangleProperty	Consultez les notes.	Rectangle le plus externe qui contient l’ensemble du contrôle.
ClickablePointProperty	Consultez les notes.	Le point interactif du contrôle d’image doit être un point dans le rectangle englobant du contrôle Image.
IsKeyboardFocusableProperty	Consultez les notes.	Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
NameProperty	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 de contrôle de l’arborescence UI Automation et n'a pas besoin d'avoir un nom. 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.
LabeledByProperty	Consultez les notes.	S’il existe une étiquette de texte statique, cette propriété doit exposer une référence à ce contrôle.
ControlTypeProperty	Image	Cette valeur est la même pour toutes les infrastructures d’interface utilisateur.
LocalizedControlTypeProperty	« image »	Chaîne localisée correspondant au type de contrôle Image.
IsContentElementProperty	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.
IsControlElementProperty	Vrai	Le contrôle d’image est toujours inclus dans la vue de contrôle de l’arborescence UI Automation.
HelpTextProperty	Consultez les notes.	La propriété HelpText expose une chaîne localisée qui décrit l'apparence visuelle exacte du contrôle (par exemple, un carré rouge avec un « X » blanc) 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, un graphique ou un diagramme compliqué. Cette propriété est mappée à la balise HTML LongDesc et à la balise Desc des graphiques vectoriels adaptatifs (SVG). 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 associée à la propriété VisualDescription d'UI Automation.
ItemStatusProperty	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.

Modèles de contrôle UI Automation obligatoires

Le tableau suivant répertorie les modèles de contrôle UI Automation requis pour être pris en charge par tous 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	Remarques
IGridItemProvider	Dépend	Le contrôle Image prend en charge le modèle Élément de grille si le contrôle est à l’intérieur d’un conteneur de grille.
ITableItemProvider	Dépend	Le contrôle Image prend en charge le modèle Élément de grille si le contrôle est à l’intérieur d’un conteneur disposant de contrôles Header.
IInvokeProvider	Jamais	Si le contrôle image contient une image cliquable, le contrôle doit prendre en charge un type de contrôle qui prend en charge le modèle Invoke, tel que le type de contrôle Button.
ISelectionItemProvider	Jamais	Les contrôles Image ne doivent pas prendre en charge le modèle Selection Item.

Événements UI Automation obligatoires

Le tableau suivant répertorie les événements UI Automation requis pour être pris en charge par tous les 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	Soutien	Remarques
InvokedEvent	Jamais	Aucun
ElementAddedToSelectionEvent	Jamais	Aucun
ElementRemovedFromSelectionEvent	Jamais	Aucun
ElementSelectedEvent	Jamais	Aucun
Événement de modification de la propriété BoundingRectangleProperty.	Obligatoire	Aucun
Événement de modification de la propriété IsOffscreenProperty.	Obligatoire	Aucun
Événement de modification de la propriété IsEnabledProperty.	Obligatoire	Aucun
Événement de modification de la propriété NameProperty.	Obligatoire	Aucun
AutomationFocusChangedEvent	Obligatoire	Aucun
StructureChangedEvent	Obligatoire	Aucun

Voir aussi

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