Partager via


Comment utiliser des groupes dans un List-View

Cette rubrique explique comment créer un instance d’un groupe et l’ajouter à un contrôle list-view. Le regroupement permet à un utilisateur d’organiser des listes en groupes d’éléments qui sont visuellement divisés sur la page, à l’aide d’un séparateur horizontal et d’un titre de groupe.

Bon à savoir

Technologies

Prérequis

  • C/C++
  • Programmation de l’interface utilisateur Windows

Instructions

Pour utiliser des groupes dans un contrôle list-view, assurez-vous que le contrôle inclut le style de fenêtre LVS_ALIGNTOP .

Lorsque vous ajoutez un élément à la liste, vous l’affectez à un groupe en définissant le membre iGroupId de la structure LVITEM de l’élément sur la valeur du membre iGroupId de la structure LVGROUP des groupes. Un élément qui n’est pas affecté à un groupe n’apparaît pas dans la liste lorsque l’affichage de groupe est activé. Pour activer ou désactiver l’affichage de groupe, utilisez la macro ListView_EnableGroupView .

L’exemple suivant montre comment créer un groupe avec un en-tête et l’ajouter à un contrôle list-view.

    LVGROUP group;

    group.cbSize    = sizeof(LVGROUP);
    group.mask      = LVGF_HEADER | LVGF_GROUPID;
    group.pszHeader = TEXT("Dogs");
    group.iGroupId  = 1;

    ListView_InsertGroup(hWndListView, -1, &group);

Informations de référence sur les contrôles List-View

À propos des contrôles List-View

Utilisation de contrôles List-View