Modèle de contrôle de table

Décrit les instructions et conventions pour l’implémentation d’ITableProvider, y compris des informations sur les propriétés et les méthodes. Le modèle de contrôle Table est utilisé pour prendre en charge les contrôles qui font office de conteneurs pour une collection d’éléments enfants.

Les enfants de l’élément conteneur doivent implémenter ITableItemProvider et être organisés dans un système de coordonnées logique à deux dimensions qui peut être parcouru par ligne et colonne. Ce modèle de contrôle est analogue à IGridProvider , avec la distinction 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 Types de contrôles et leurs modèles de contrôle pris en charge.

Cette rubrique contient les sections suivantes.

Conventions et directives d'implémentation

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

  • L’accès au contenu de cellules individuelles se fait par le biais d’un système de coordonnées logiques à deux dimensions ou d’un tableau fourni par l’implémentation simultanée requise d’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 apparaît dans une feuille de calcul Microsoft Excel où un utilisateur a défini une colonne Prénom . Cette colonne comporte désormais deux en-têtes, dont 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.

     

  • Pour connaître les fonctionnalités de grille associées, consultez Modèle de contrôle de grille.

    L’image suivante montre un tableau avec des en-têtes de colonne complexes.

    table avec des en-têtes de colonne complexes

    L’image suivante montre une table avec une propriété ITableProvider::RowOrColumnMajor ambiguë.

    table avec une propriété roworcolumnmajor ambiguë

Membres requis pour ITableProvider

Les propriétés et méthodes suivantes sont requises pour implémenter 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.

Conceptuel

Types de contrôles et leurs modèles de contrôle pris en charge

Modèle de contrôle TableItem

Vue d'ensemble des modèles de contrôle UI Automation

Vue d’ensemble de l’arborescence UI Automation