Partager via

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

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 présente des instructions et des conventions pour l’implémentation de ITableProvider, y compris des informations sur les propriétés, les méthodes et les événements. Les 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 permet de prendre en charge les contrôles qui agissent comme des 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 colonne. Ce modèle de contrôle est analogue à IGridProvider, à la différence que tout contrôle implémentant 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 des modèles de contrôle pour les clients UI Automation.

Directives et conventions de mise en œuvre

Lors de l’implémentation du modèle de contrôle Table, notez les instructions et conventions suivantes :

  • L’accès au contenu des cellules individuelles est via un système de coordonnées logique ou tableau bidimensionnel fourni 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 d’en-tête distinct associé à un objet table.

  • Les en-têtes de colonne et de ligne peuvent inclure à la fois un en-tête principal ainsi que tous les en-têtes de prise en charge.

Remarque

Ce concept devient évident dans une feuille de calcul Microsoft Excel où un utilisateur a défini une colonne « Prénom ». Cette colonne comporte maintenant deux en-têtes : l’en-tête « Prénom » défini par l’utilisateur et la désignation alphanumérique pour cette colonne affectée par l’application.

Tableau avec des éléments d’en-tête complexes. Exemple de tableau avec en-têtes de colonne complexes

Table avec une propriété RowOrColumnMajor ambiguë. Exemple de table avec la propriété RowOrColumnMajor ambiguë

Membres requis pour ITableProvider

Les propriétés et méthodes suivantes sont requises pour l’interface ITableProvider.

Membres obligatoires Type de membre Remarques
RowOrColumnMajor Propriété Aucun
GetColumnHeaders Méthode Aucun
GetRowHeaders Méthode Aucun

Ce modèle de contrôle n’a aucun événement associé.

Exceptions

Ce modèle de contrôle n’a aucune exception associée.

Voir aussi