Partager via


Modèle de contrôle de table

Décrit les instructions et conventions d’implémentation 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 agissent en tant que 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 logiques à deux dimensions qui peut être parcouru par ligne et colonne. Ce modèle de contrôle est analogue à IGridProvider avec la distinction selon laquelle 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ôle et leurs modèles de contrôle pris en charge.

Cette rubrique contient les sections suivantes.

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 logiques ou un 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.

    Note

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

     

  • Consultez modèle de contrôle grid pour connaître les fonctionnalités de grille associées.

    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.

    table avec une propriété roworcolumnmajor ambigu

Membres obligatoires pour ITableProvider

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

Membres obligatoires Type de membre Notes
RowOrColumnMajor Propriété Aucun
GetColumnHeaders Méthode Aucun
getRowHeaders Méthode Aucun

 

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

conceptuelle

types de contrôle 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