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

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 Table. 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 de tableau contiennent des lignes et des colonnes de texte, et éventuellement, des en-têtes de ligne et des en-têtes de colonne.

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 Table. Les exigences UI Automation s’appliquent à tous les contrôles de table, que Windows Presentation Foundation (WPF), Win32 ou Windows Forms.

Arborescence UI Automation obligatoire

Le tableau suivant illustre l’affichage de contrôle et la vue de contenu de l’arborescence UI Automation qui se rapporte aux contrôles de table 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
Tableau - En-tête (0 ou 1) - Texte (0 ou 1) - Différents contrôles (0 ou plus)	Tableau - Texte (0 ou plus) - Différents contrôles (0 ou plus)

Si un contrôle de table possède des en-têtes de lignes ou de colonnes, ceux-ci doivent être exposés dans la vue de contrôle de l’arborescence UI Automation. La vue de contenu n’a pas besoin d’exposer ces informations, car elle est accessible à l’aide de TablePattern.

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 les contrôles Table. 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.	Prise en charge s’il existe un rectangle englobant. Si les points du rectangle englobant ne sont pas tous interactifs et que vous effectuez un test de positionnement spécialisé, vous devez remplacer et fournir un point interactif.
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.	Le contrôle de table obtient généralement son nom à partir d’une étiquette de texte statique. S’il n’existe aucune étiquette de texte statique, vous devez affecter une propriété Name qui doit toujours être disponible pour expliquer l’objectif de la table.
LabeledByProperty	Consultez les notes.	S’il existe une étiquette de texte statique, cette propriété doit exposer une référence à l’élément Automation du contrôle.
ControlTypeProperty	Tableau	Cette valeur est la même pour toutes les infrastructures d’interface utilisateur.
LocalizedControlTypeProperty	« table »	Chaîne localisée correspondant au type de contrôle Table.
HelpTextProperty	Consultez les notes.	Des détails supplémentaires sur l’objectif de la table doivent être exposés via cette propriété si elle n’est pas suffisamment expliquée par l’accès à NameProperty.
IsContentElementProperty	Vrai	Le contrôle de table doit toujours être du contenu.
IsControlElementProperty	Vrai	Le contrôle de table doit toujours être un contrôle.

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 les contrôles Table. 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
IGridProvider	Oui	Le contrôle de table prend toujours en charge ce modèle de contrôle, car les éléments qu’il contient contiennent des données présentées dans une grille.
IGridItemProvider	Oui (requise avec les objets enfants)	Les objets internes d’une table doivent prendre en charge les modèles de contrôle GridItem et TableItem. La table elle-même n’a pas besoin de prendre en charge les modèles de contrôle GridItem ou TableItem, sauf si la table fait partie d’une autre table.
ITableProvider	Oui	Le contrôle de table a toujours la possibilité d’avoir des en-têtes associés au contenu.
ITableItemProvider	Oui (requise avec les objets enfants)	Les objets internes d’une table doivent prendre en charge les modèles de contrôle GridItem et TableItem. La table elle-même n’a pas besoin de prendre en charge les modèles de contrôle GridItem ou TableItem, sauf si la table fait partie d’une autre table.

É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 de table. Pour plus d’informations sur les événements, consultez vue d’ensemble des événements UI Automation.

Événement UI Automation	Soutien	Remarques
É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
AutomationFocusChangedEvent	Obligatoire	Aucun
StructureChangedEvent	Obligatoire	Aucun

Voir aussi

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