Modèle de contrôle de grille

  • Article

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

Les enfants de cet élément doivent implémenter IGridItemProvider et être organisés dans un système de coordonnées logiques à deux dimensions qui peut être parcouru par ligne et colonne. 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 Grid , notez les directives et conventions suivantes :

  • Les coordonnées de grille sont de base zéro, la cellule supérieure gauche (ou la cellule supérieure droite selon les paramètres régionaux) ayant des coordonnées (0,0).

  • Si une cellule est vide, un élément Microsoft UI Automation doit toujours être retourné pour prendre en charge la propriété IGridItemProvider::ContainingGrid pour cette cellule. Cela est possible quand la disposition des éléments enfants de la grille est semblable à celle d’un tableau non justifié (consultez l’exemple ci-dessous).

    exemple de contrôle de grille avec des coordonnées vides

  • Une grille avec un seul élément est toujours nécessaire pour implémenter IGridProvider si elle est logiquement considérée comme une grille. Le nombre d’éléments enfants de la grille est immatériel.

  • Les lignes et colonnes masquées, selon l’implémentation du fournisseur, peuvent être chargées dans l’arborescence UI Automation et sont donc répercutées dans les propriétés IGridProvider::RowCount et ColumnCount. Si les lignes et les colonnes masquées n’ont pas encore été chargées, elles ne doivent pas être comptabilisées.

  • IGridProvider n’active pas la manipulation active d’une grille ; ITransformProvider doit être implémenté pour activer cette fonctionnalité.

  • Utilisez un IUIAutomationStructureChangedEventHandler pour écouter les modifications structurelles ou de disposition apportées à la grille, telles que les cellules qui ont été ajoutées, supprimées ou fusionnées.

  • Utilisez un IUIAutomationFocusChangedEventHandler pour suivre le parcours à travers les éléments ou les cellules d’une grille.

Membres requis pour IGridProvider

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

Membres nécessaires Type de membre Notes
Rowcount Propriété Aucun
ColumnCount Propriété Aucun
GetItem Méthode Aucun

 

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

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

Modèle de contrôle GridItem

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

Vue d’ensemble de l’arborescence UI Automation