Implémentation du modèle de contrôle Table d'UI Automation

Article
08/10/2011

Remarque
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 présente les conventions et directives à respecter pour implémenter ITableProvider, notamment les informations sur les propriétés, les méthodes et les événements. Des liens vers des références supplémentaires sont répertoriés à la fin de la vue d'ensemble.

Le modèle de contrôle TablePattern est utilisé pour prendre en charge les contrôles qui agissent en tant que conteneurs pour une collection d'éléments enfants. Les enfants de cet élément doivent implémenter ITableItemProvider et être organisés dans un système de coordonnées logiques à deux dimensions qui peut être parcouru par ligne et par colonne. Ce modèle de contrôle est analogue à IgridProvider, à cette distinction près que tout contrôle qui implémente ITableProvider doit également exposer une relation d'en-tête de colonne et/ou de ligne pour chaque élément enfant. Pour obtenir des exemples de contrôles qui implémentent ce modèle de contrôle, consultez Mappage de modèle de contrôle pour les clients UI Automation.

Cette rubrique comprend les sections suivantes.

Conventions et instructions de l'implémentation
Membres requis pour ITableProvider
Exceptions
Rubriques connexes

Conventions et instructions de l'implémentation

Lorsque vous implémentez le modèle de contrôle Table, notez les conventions et instructions suivantes :

L'accès au contenu des cellules individuelles se fait via un système de coordonnées logiques à deux dimensions ou une table fournie par l'implémentation simultanée requise de IGridProvider.
Un en-tête de colonne ou de ligne peut être contenu dans un objet table ou être un objet en-tête séparé, associé à un objet table.
Les en-têtes de colonnes et de lignes peuvent inclure un en-tête principal ainsi que tous les en-têtes pris en charge.

Remarque
Ce concept apparaît clairement dans une feuille de calcul Microsoft Excel où un utilisateur a défini une colonne « Prénom ».Cette colonne a désormais deux en-têtes ; l'en-tête « Prénom », défini par l'utilisateur, et la désignation alphanumérique de cette colonne, assignée par l'application.