Comment : afficher des en-têtes d'élément dans un contrôle DataRepeater (Visual Studio)

Mise à jour : Juillet 2008

L'en-tête d'élément d'un contrôle DataRepeater fournit un indicateur visuel lorsqu'un DataRepeaterItem est sélectionné. Lorsque la propriété LayoutStyle a la valeur Vertical (valeur par défaut), l'en-tête d'élément apparaît à gauche de chaque élément. Lorsque la propriété LayoutStyle a la valeur Horizontal, l'en-tête d'élément apparaît en haut de chaque élément.

Lorsqu'il est sélectionné en premier, l'en-tête d'élément apparaît dans la couleur spécifiée par la propriété SelectionColor et une icône représentant une flèche blanche s'affiche.

Remarque :
Si vous affectez à SelectionColor la valeur White, le symbole de sélection n'apparaît pas lorsque l'élément est sélectionné pour la première fois.

Lorsqu'un champ de DataRepeaterItem a le focus, la couleur de l'en-tête d'élément devient celle de l'arrière-plan ItemTemplate et l'icône de la flèche devient noire. Si vous modifiez des données, un symbole de crayon apparaît dans l'en-tête d'élément.

La largeur par défaut (ou hauteur lorsque la propriété LayoutStyle a la valeur Horizontal) de l'en-tête d'élément est de 15 pixels. Vous pouvez changer la largeur en définissant la propriété ItemHeaderSize.

Remarque :
Si la propriété ItemHeaderSize a une valeur inférieure à 11, les symboles d'indicateur n'apparaissent pas dans l'en-tête d'élément.

Vous pouvez masquer les en-têtes d'élément en attribuant la valeur False au paramètre ItemHeaderVisible. Lorsque ItemHeaderVisible a la valeur False, la seule indication qu'un élément est sélectionné est un trait pointillé autour du périmètre du DataRepeaterItem.

Remarque :
Vous pouvez également fournir votre propre indicateur de sélection en surveillant la propriété IsCurrent du DataRepeaterItem dans l'événement DrawItem du contrôle DataRepeater. Pour plus d'informations, consultez IsCurrent.

Pour modifier l'apparence des en-têtes d'élément

1. Dans le Concepteur Windows Forms, sélectionnez la région inférieure du contrôle DataRepeater.

   Remarque :
   Vous devez sélectionner la région inférieure du contrôle. Si vous sélectionnez la section modèle d'élément, un jeu différent de propriétés apparaîtra dans la fenêtre Propriétés.

2. Dans la fenêtre Propriétés, vous pouvez utiliser la propriété SelectionColor pour changer la couleur des en-têtes d'élément.

   Remarque :
   Si vous affectez à SelectionColor la valeur White, le symbole de sélection n'apparaît pas lorsque l'élément est sélectionné en premier.

3. Utilisez la propriété ItemHeaderSize pour modifier la largeur (ou la hauteur) des en-têtes d'élément.

   Remarque :
   Si la propriété ItemHeaderSize a une valeur inférieure à 11, les symboles d'indicateur n'apparaissent pas dans l'en-tête d'élément.

Pour masquer des en-têtes d'élément

1. Dans le Concepteur Windows Forms, sélectionnez la région inférieure du contrôle DataRepeater.

   Remarque :
   Vous devez sélectionner la région inférieure du contrôle. Si vous sélectionnez la section modèle d'élément, un jeu différent de propriétés apparaîtra dans la fenêtre Propriétés.

2. Dans la fenêtre Propriétés, attribuez la valeur False à la propriété ItemHeaderVisible.

   Lorsqu'un élément de DataRepeater est sélectionné, la seule indication est un trait pointillé autour du périmètre du DataRepeaterItem.

Voir aussi

Tâches

Comment : modifier l'apparence d'un contrôle DataRepeater (Visual Studio)

Comment : modifier la disposition d'un contrôle DataRepeater (Visual Studio)

Dépannage des problèmes liés au contrôle DataRepeater (Visual Studio)

Concepts

Introduction au contrôle DataRepeater (Visual Studio)

Référence

DataRepeater

Historique des modifications