Partager via


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

RemarqueRemarque

Cette documentation s'adresse aux développeurs .NET Framework qui veulent 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 (page éventuellement en anglais).

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

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

Les sections suivantes définissent l'arborescence UI Automation, les propriétés, les modèles de contrôle et les événements requis pour le type de contrôle Image. Les spécifications UI Automation s'appliquent à tous les contrôles d'image, qu'il s'agisse de Windows Presentation Foundation (WPF), Win32 ou Windows Forms.

Cette rubrique comprend les sections suivantes.

  • Arborescence UI Automation requise
  • Propriétés UI Automation requises
  • Modèles de contrôle UI Automation requis
  • Événements UI Automation requis
  • Rubriques connexes

Arborescence UI Automation requise

Le tableau suivant représente l'affichage de contrôle et l'affichage du contenu de l'arborescence UI Automation concernant les contrôles image et décrit ce qui peut être inclus dans chaque affichage. Pour plus d'informations sur l'arborescence UI Automation, consultez Vue d'ensemble de l'arborescence UI Automation.

Affichage de contrôle

Affichage du contenu

Image

Image (selon que l'image contient des informations (basées sur la valeur de la propriété IsContentElement))

Propriétés UI Automation requises

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

Consulter les remarques.

La valeur de cette propriété doit être unique dans tous les contrôles d'une application.

BoundingRectangleProperty

Consulter les remarques.

Le rectangle le plus éloigné qui contient l'ensemble du contrôle.

ClickablePointProperty

Consulter les remarques.

Le point interactif du contrôle d'image doit être un point situé dans le rectangle englobant du contrôle d'image.

IsKeyboardFocusableProperty

Consulter les remarques.

Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.

NameProperty

Consulter les remarques.

La propriété Name doit être exposée pour tous les contrôles d'image qui contiennent des informations. L'accès par programme à ces informations requiert qu'un équivalent textuel du graphique soit fourni. Si le contrôle d'image est purement décoratif, il doit s'afficher uniquement dans l'affichage de contrôle de l'arborescence UI Automation et ne doit pas nécessairement porter un nom. Les infrastructures d'interface utilisateur doivent prendre en charge une propriété de texte de remplacement sur les images qui peuvent être définies à partir de leur infrastructure. Cette propriété correspondra ensuite à la propriété Name UI Automation.

LabeledByProperty

Consulter les remarques.

Si une étiquette de texte statique est présente, alors 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

Consulter 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 explicites qui ne sont pas déjà exposées à l'utilisateur final.

IsControlElementProperty

True

Le contrôle d'image est toujours inclus dans l'affichage de contrôle de l'arborescence UI Automation.

HelpTextProperty

Consulter les remarques.

La propriété HelpText expose une chaîne localisée qui décrit l'apparence visuelle réelle 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 longue description est nécessaire pour transmettre davantage d'informations sur le contrôle d'image. Par exemple, un diagramme ou un graphique compliqué. Cette propriété mappe à la balise HTML LongDesc et la balise Vector Graphics (SVG) Desc. Les développeurs utilisant des contrôles d'image doivent prendre en charge une propriété pour permettre la définition de la description visuelle sur le contrôle. Cette propriété doit être mappée à la propriété UI Automation VisualDescription.

ItemStatusProperty

Consulter les remarques.

Si le contrôle d'image représente des informations d'état concernant un élément particulier sur 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 transmet l'état, cette propriété doit être prise en charge.

Modèles de contrôle UI Automation requis

Le tableau suivant répertorie les modèles de contrôle UI Automation qui doivent ê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

Prise en charge

Remarques

IGridItemProvider

Selon le cas

Le contrôle d'image prend en charge le modèle Grid Item si le contrôle est à l'intérieur d'un conteneur de grille.

ITableItemProvider

Selon le cas

Le contrôle d'image prend en charge le modèle Table Item si le contrôle est à l'intérieur d'un conteneur disposant de contrôles header.

IInvokeProvider

Jamais

Si le contrôle d'image contient une image interactive, 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 d'image ne doivent pas prendre en charge le modèle Selection Item.

Événements UI Automation requis

Le tableau suivant répertorie les événements UI Automation qui doivent ê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

Prise en charge

Remarques

InvokedEvent

Jamais

Aucun

ElementAddedToSelectionEvent

Jamais

Aucun

ElementRemovedFromSelectionEvent

Jamais

Aucun

ElementSelectedEvent

Jamais

Aucun

Événement de modification de propriété BoundingRectangleProperty.

Obligatoire

Aucun

Événement de modification de propriété IsOffscreenProperty.

Obligatoire

Aucun

Événement de modification de propriété IsEnabledProperty.

Obligatoire

Aucun

Événement de modification de propriété NameProperty.

Obligatoire

Aucun

AutomationFocusChangedEvent

Obligatoire

Aucun

StructureChangedEvent

Obligatoire

Aucun

Voir aussi

Référence

Image

Concepts

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

Vue d'ensemble d'UI Automation