Comment faire pour trier les éléments dans un CListCtrl dans l'affichage de rapport

Pas beaucoup d'informations a été fourni pour le processus de tri des éléments dans un contrôle ListView, en particulier une encapsulé par la classe MFC CListCtrl. Les détails sont faciles à implémenter et cet article tente de remplir l'espace dans la documentation pour cette fonctionnalité utile. L'exemple de code représente une boîte de dialogue MFC avec un contrôle de liste défini pour le style LVS_REPORT.

Pour trier les éléments dans un contrôle ListView, il doit y avoir une structure LVITEM associée à l'élément. MFC fournit ce pour les développeurs, permettant à un élément à insérer par un appel de fonction InsertItem(int nItem, LPCTSTR lpszItem) simple qui crée la structure avec les valeurs par défaut raisonnables. Telle une mémoire tampon à partir de la complexité sous-jacente peut parfois être trompeur. Toutefois, la structure LVITEM est une clé importante pour manipuler des éléments ListView, y compris le mécanisme de tri.

L'élément lParam du LVITEM fournit les informations nécessaires. Lorsque la fonction SortItems de la classe CListCtrl est appelée, elle doit fournir un pointeur fonction vers une fonction de rappel de tri et une valeur DWORD définie par l'application. Pendant le tri, la fonction de rappel est appelée à plusieurs reprises que deux éléments du contrôle de liste sont sélectionnés pour la comparaison. Les paramètres qu'il reçoit constituent l'élément lParam à partir LVITEM structure de chaque élément et la valeur DWORD passé par l'appel SortItems.

Le code ci-dessous représente un exemple simple de tri d'une liste des présidents de dix américain dans un contrôle ListView. Les présidents sont initialement stockés dans un tableau statique de CString multidimensionnel.


La fonction de tri de rappel peut être définie statiquement en tant que membre d'une classe ou, comme ici, simplement comme fonction globale :

L'élément lParam peut s'agir de simple à très complexes. Fréquemment, une structure est utile dans ce contexte, permettant à plusieurs éléments de données à référencer. Par exemple, une structure appelée ITEMDATA a été définie pour contenir les trois éléments comprenant un élément donné :

Dans cet exemple, la structure a été définie dans fichier d'en-tête d'une classe CDialog et une variable de membre d'un pointeur vers un tableau de 10 a été définie :

Un contrôle ListView a été ajouté à une boîte de dialogue et une variable de membre défini par l'appelé m_ctlListView. Ils ont été ajoutés dans OnInitDialog :


Trois colonnes ont été insérés pour le dernier nom, prénom et durée du mandat. Ensuite, pour chacune des dix éléments, une nouvelle structure ITEMDATA est allouée et initialisée à partir du tableau de CString. L'élément est inséré très simplement, à l'aide uniquement l'index et de la dernière chaîne de nom, puis le texte est défini pour les deux autres colonnes de l'élément. Enfin, la fonction SetItemData est appelée, en passant le ITEMDATA nouvelle en tant que paramètre. Ceci réinitialise le lParam de la structure de l'article LVITEM et prépare la façon dont le tri.

Les MFC dans Visual C++ 6.0 a un problème avec des notifications d'en-tête pour le contrôle ListView. Bien qu'un gestionnaire peut être ajouté, dans la version actuelle il n'est pas appelé. Utilisez par exemple, Assistant classe ou la barre Assistant pour ajouter un gestionnaire de messages Windows. Si l'ID du contrôle ListView est en surbrillance, un nombre de messages de notification est disponible pour sélection. Pour trier les éléments lorsqu'un clic est effectué sur l'en-tête pour une colonne donnée, sélectionnez la notification HDN_ITEMCLICK. Une entrée de la table des messages ON_NOTIFY est générée, mais aussi une fonction gestionnaire. Par exemple en cours, l'entrée apparaît comme suit :


Le problème ici est que la notification n'est pas proviennent en fait le contrôle ListView ; au lieu de cela, le contrôle d'en-tête créé par le ListView envoie la notification. L'entrée de la table des messages répertoriée ci-dessus ne fonctionne pas. La solution est simple, cependant, dans la mesure où le contrôle d'en-tête a toujours une valeur d'ID de 0, la macro peut être modifiée pour fonctionner correctement :

Puis, dans le Gestionnaire OnItemclickList1, l'appel SortItems est effectué :

L'en-tête de message de notification (NMHDR) est en fait une notification de ListView, NMLISTVIEW, qui contient l'index de la colonne sur laquelle l'utilisateur a cliqué. Dans cet exemple, il est représenté par iItem. Listes plus complexes devrez référencer l'élément iSubItem de cette structure également. L'adresse de la fonction de rappel est passée à SortItems, ainsi que le numéro de colonne qui a été activé.

La routine SortFunc est appelée à plusieurs reprises que les paires d'éléments de ListView sont passées à la fonction de comparaison. Les deux premiers paramètres sont l'élément de lParam de structure LVITEM les éléments de respectifs et le troisième paramètre (défini par l'application) est le numéro de la colonne dans l'appel SortItems.

L'index de colonne passé lParamSort détermine quel élément des objets ITEMDATA passé dans lParam1 et lParam2 doit être utilisé pour la comparaison. Le résultat est renvoyé et le processus continue jusqu'à ce que tous les éléments ont été triées.

En tant qu'un rappel, les structures ITEMDATA qui ont été attribués pour les éléments de liste devez finit par être détruits. Par exemple, le gestionnaire WM_DESTROY pour la boîte de dialogue parcourt les éléments de membre et les supprime.

Pour plus d'informations sur le contrôle commun de ListView, consultez la documentation Du Kit de développement Platform SDK sous Contrôles communs Windows dans la section Services d'interface utilisateur.