Partager via


Comment : grouper des éléments dans un contrôle ListView Windows Forms

À l'aide de la fonctionnalité de regroupement du contrôle ListView, vous pouvez afficher des jeux d'éléments liés dans les groupes. Ces groupes sont séparés à l'écran par des en-têtes de groupes horizontaux qui contiennent les titres des groupes. Vous pouvez utiliser des groupes ListView pour faciliter la navigation dans les longues listes en regroupant les éléments par ordre alphabétique, par date ou par tout autre regroupement logique. L'image suivante présente des éléments regroupés.

Éléments ListView regroupés

Groupes ListView

Pour activer le regroupement, vous devez tout d'abord créer un ou plusieurs groupes, dans le concepteur ou par programme. Après avoir défini un groupe, vous pouvez assigner des éléments ListView aux groupes. Vous pouvez également déplacer par programme des éléments d'un groupe à un autre.

Notes

Les groupes ListView sont disponibles uniquement sur Windows XP Édition familiale, Windows XP Professionnel, Windows Server 2003 lorsque votre application appelle la méthode Application.EnableVisualStyles. Sur les systèmes d'exploitation antérieurs, tout code concernant les groupes est sans effet et les groupes n'apparaissent pas. Pour plus d'informations, consultez ListView.Groups.

Pour ajouter des groupes

  • Utilisez la méthode Add de la collection Groups.

    ' Adds a new group that has a left-aligned header
    ListView1.Groups.Add(New ListViewGroup("Group 1", _
     HorizontalAlignment.Left))
    
    // Adds a new group that has a left-aligned header
    listView1.Groups.Add(new ListViewGroup("List item text",
        HorizontalAlignment.Left));
    

Pour supprimer des groupes

  • Utilisez la méthode RemoveAt ou Clear de la collection Groups.

    La méthode RemoveAt supprime un seul groupe, alors que la méthode Clear supprime tous les groupes de la liste.

    Notes

    La suppression d'un groupe ne supprime pas les éléments de ce groupe.

    ' Removes the first group in the collection.
    ListView1.Groups.RemoveAt(0)
    ' Clears all groups:
    ListView1.Groups.Clear()
    
    // Removes the first group in the collection.
    listView1.Groups.RemoveAt(0);
    // Clears all groups.
    listView1.Groups.Clear();
    

Pour assigner des éléments aux groupes ou déplacer des éléments entre des groupes

  • Définissez la propriété ListViewItem.Group des éléments.

    ' Adds the first item to the first group
    ListView1.Items.Item(0).Group = ListView1.Groups(0)
    
    // Adds the first item to the first group
    listView1.Items[0].Group = listView1.Groups[0];
    

Voir aussi

Tâches

Comment : ajouter et supprimer des éléments avec le contrôle ListView Windows Forms

Référence

Vue d'ensemble du contrôle ListView (Windows Forms)

ListView

ListView.Groups

ListViewGroup

Concepts

Fonctionnalités de Windows XP et contrôles Windows Forms

Autres ressources

ListView, contrôle (Windows Forms)