Partager via

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

  • Article

Notes

Cette documentation s’adresse 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 dernières informations sur UI Automation, consultez API Windows Automation : UI Automation.

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 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 en 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, à 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 implémentant ce modèle de contrôle, consultez Control Pattern Mapping for UI Automation Clients.

Conventions et directives d'implémentation

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

  • L’accès au contenu des cellules individuelles s’effectue via un système de coordonnées logiques à deux dimensions ou un tableau fourni par l’implémentation simultanée requise de IGridProvider.

  • Un en-tête de colonne ou de ligne peut figurer dans un objet table ou être un objet d’en-tête séparé, associé à un objet table.

  • Les en-têtes de colonne et de ligne peuvent inclure un en-tête principal et des en-têtes de prise en charge quelconques.

Notes

Ce concept est visible dans une feuille de calcul Microsoft Excel sur laquelle 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 affectée par l’application.

Table with complex header items. Exemple de tableau comportant des en-têtes de colonnes complexes

Table with ambiguous RowOrColumnMajor property. Exemple de tableau comportant une propriété RowOrColumnMajor ambiguë

Membres requis pour ITableProvider

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

Membres nécessaires Type de membre Notes
RowOrColumnMajor Propriété Aucun
GetColumnHeaders Méthode Aucun
GetRowHeaders Méthode Aucun

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

Exceptions

Ce modèle de contrôle n’est associé à aucune exception.

Voir aussi