Partager via

Éléments DataGrid

Le DataGrid contrôle est composé de plusieurs types de composants spécialisés qui fonctionnent ensemble pour afficher et gérer des données tabulaires. Comprendre ces composants et leur relation avec ceux-ci DataGrid vous aident à personnaliser l’apparence et le comportement de la grille de données pour répondre à vos besoins spécifiques.

Vue d’ensemble de l’élément

Les principaux éléments de DataGrid sont les suivants :

  • DataGridCell - Représente une cellule individuelle dans la grille qui affiche une valeur de données unique.
  • DataGridRow - Représente une ligne de données dans la grille contenant plusieurs cellules.
  • DataGridRowHeader - Fournit la zone d’en-tête de ligne située à gauche de chaque ligne, généralement utilisée pour les indicateurs de sélection de ligne.
  • DataGridColumnHeader - Représente l’en-tête d’une colonne, affichant généralement le titre de la colonne et fournissant des fonctionnalités de tri.
  • DataGridColumnHeadersPresenter - Contient et présente tous les en-têtes de colonne en une ligne en haut de la grille.

Ces éléments sont organisés hiérarchiquement à l'intérieur du DataGrid pour créer la disposition tabulaire familière. Le DataGridColumnHeadersPresenter affiche les en-têtes de colonne en haut, et chacun DataGridRow contient plusieurs éléments DataGridCell ainsi qu'un DataGridRowHeader.

Personnalisation d’éléments

Vous pouvez personnaliser chaque élément en appliquant des styles ou en modifiant des modèles. Par exemple:

Pour plus d’informations sur le style et la création de modèles, consultez Style et Création de modèles.

DataGridCell

L’élément DataGridCell représente une cellule individuelle dans la grille de données et répond aux interactions utilisateur telles que la sélection et la modification.

Pièces

L’élément DataGridCell ne définit aucune partie de modèle nommée.

States

Le tableau suivant répertorie les états visuels de l’élément DataGridCell .

Nom VisualState Nom du VisualStateGroup Descriptif
Normale CommonStates État par défaut.
Survol de la souris CommonStates Le pointeur de la souris est positionné sur la cellule.
Focused FocusStates La cellule a le focus.
Floue FocusStates La cellule n’a pas le focus.
En cours ÉtatsActuels La cellule est la cellule actuelle.
Régulier CurrentStates La cellule n'est pas la cellule actuelle.
Display InteractionStates La cellule est en mode d’affichage.
Modification InteractionStates La cellule est en mode édition.
Sélectionnée ÉtatsDeSélection La cellule est sélectionnée.
Non sélectionné ÉtatsDeSélection La cellule n’est pas sélectionnée.
NonValideConcentré ValidationStates La cellule n’est pas valide et a le focus.
InvalideNonFocalisé ValidationStates La cellule n’est pas valide et n'est pas focalisée.
Valide ValidationStates La cellule est valide.

DataGridRow

L’élément DataGridRow représente une ligne de données dans la grille. Chaque ligne contient plusieurs cellules et un en-tête de ligne.

Pièces

L’élément DataGridRow ne définit aucune partie de modèle nommée.

States

Le tableau suivant répertorie les états visuels de l’élément DataGridRow .

Nom VisualState Nom du VisualStateGroup Descriptif
Normale CommonStates État par défaut.
Survol de la souris CommonStates Le pointeur de la souris est positionné sur la ligne.
Survol de la souris - Édition CommonStates Le pointeur de la souris est positionné sur la ligne et la ligne est en mode édition.
Survol_Sélectionné CommonStates Le pointeur de la souris est positionné sur la ligne et la ligne est sélectionnée.
Survol_SansFocus_Édition CommonStates Le pointeur de la souris est positionné sur la ligne, la ligne est en mode édition et n’a pas le focus.
Survol_NonConcentré_Sélectionné CommonStates Le pointeur de la souris est positionné sur la rangée, la rangée est sélectionnée et n'est pas en focus.
Normal_AlternatingRow CommonStates La ligne est une ligne alternée.
Normal_Editing CommonStates La ligne est en mode édition.
Sélectionné_Normal CommonStates La ligne est sélectionnée.
Édition non focalisée CommonStates La ligne est en mode édition et n'est pas focalisée.
Non_focalisé_sélectionné CommonStates La rangée est sélectionnée et n'est pas au premier plan.
NonValideConcentré ValidationStates Le contrôle n’est pas valide et a le focus.
InvalideNonFocalisé ValidationStates Le contrôle n’est pas valide et n’a pas le focus.
Valide ValidationStates Le contrôle est valide.

DataGridRowHeader

L’élément DataGridRowHeader apparaît à gauche de chaque ligne et affiche généralement des indicateurs de sélection de lignes ou des numéros de ligne.

Pièces

Le tableau suivant répertorie les parties nommées de l’élément DataGridRowHeader .

Composant Type Descriptif
PART_TopHeaderGripper Thumb Élément utilisé pour redimensionner l’en-tête de ligne à partir du haut.
PART_BottomHeaderGripper Thumb L'élément utilisé pour redimensionner l'en-tête de ligne depuis le bas.

States

Le tableau suivant répertorie les états visuels de l’élément DataGridRowHeader .

Nom VisualState Nom du VisualStateGroup Descriptif
Normale CommonStates État par défaut.
Survol de la souris CommonStates Le pointeur de la souris est positionné sur la rangée.
Survol_SurLaLigneEnCours CommonStates Le pointeur de la souris est positionné sur la ligne et celle-ci est la ligne actuelle.
MouseOver_CurrentRow_Selected CommonStates Le pointeur de la souris est positionné sur la rangée, et celle-ci est actuelle et sélectionnée.
MouseOver_EditingRow CommonStates Le pointeur de la souris est positionné sur la ligne et la ligne est en mode édition.
Survol_Sélectionné CommonStates Le pointeur de la souris est positionné sur la ligne et la ligne est sélectionnée.
MouseOver_Unfocused_CurrentRow_Selected CommonStates Le pointeur de la souris est positionné sur la ligne, la ligne est active et sélectionnée et n’a pas le focus.
MouseOver_Unfocused_EditingRow CommonStates Le pointeur de la souris est positionné sur la ligne, la ligne est en cours d'édition et ne reçoit pas le focus.
Survol_Non_Focalisé_Sélectionné CommonStates Le pointeur de la souris est positionné sur la rangée, la rangée est sélectionnée et elle n’a pas le focus.
Normal_CurrentRow CommonStates La ligne est la ligne actuelle.
Normal_CurrentRow_Selected CommonStates La ligne est la ligne courante et est sélectionnée.
Normal_EditingRow CommonStates La ligne est en mode édition.
Normal_Sélectionné CommonStates La ligne est sélectionnée.
LigneCourante_NonCiblée_Sélectionnée CommonStates La ligne est la ligne actuelle, est sélectionnée et n'est pas au focus.
Unfocused_EditingRow CommonStates La ligne est en mode édition et n’a pas le focus.
Non-ciblé_Sélectionné CommonStates La ligne est sélectionnée et n’a pas le focus.
NonValideConcentré ValidationStates Le contrôle n’est pas valide et le focus est activé.
InvalideNonFocalisé ValidationStates Le contrôle n’est pas valide et n’a pas le focus.
Valide ValidationStates Le contrôle est valide.

DataGridColumnHeadersPresenter

L’élément DataGridColumnHeadersPresenter contient tous les en-têtes de colonne et les affiche dans une ligne en haut de la grille de données.

Pièces

Le tableau suivant répertorie les parties nommées de l’élément DataGridColumnHeadersPresenter .

Composant Type Descriptif
PART_FillerColumnHeader DataGridColumnHeader Espace réservé pour les en-têtes de colonne.

States

Le tableau suivant répertorie les états visuels de l’élément DataGridColumnHeadersPresenter .

Nom VisualState Nom du VisualStateGroup Descriptif
NonValideConcentré ValidationStates La cellule n’est pas valide et est en focus.
InvalideNonFocalisé ValidationStates La cellule n’est pas valide et n’a pas le focus.
Valide ValidationStates La cellule est valide.

En-tête de colonne de grille de données

L’élément DataGridColumnHeader représente l’en-tête d’une colonne. Les en-têtes de colonne affichent généralement le titre de la colonne et fournissent des fonctionnalités de tri lorsque vous cliquez dessus.

Pièces

Le tableau suivant répertorie les parties nommées de l’élément DataGridColumnHeader .

Composant Type Descriptif
PART_LeftHeaderGripper Thumb Élément utilisé pour redimensionner l'en-tête de colonne à partir de la gauche.
PART_RightHeaderGripper Thumb Élément utilisé pour redimensionner l’en-tête de colonne depuis la droite.

States

Le tableau suivant répertorie les états visuels de l’élément DataGridColumnHeader .

Nom VisualState Nom du VisualStateGroup Descriptif
Normale CommonStates État par défaut.
Survol de la souris CommonStates Le pointeur de la souris est positionné sur l'élément de commande.
Activé CommonStates La commande est appuyée.
SortAscending SortStates La colonne est triée dans l’ordre croissant.
SortDescending SortStates La colonne est triée dans l’ordre décroissant.
Non trié SortStates La colonne n’est pas triée.
NonValideConcentré ValidationStates Le contrôle n’est pas valide et le focus est activé.
InvalideNonFocalisé ValidationStates Le contrôle n’est pas valide et n’a pas le focus.
Valide ValidationStates Le contrôle est valide.

Voir aussi

  • Last updated on