message LVM_SORTITEMSEX

Utilise une fonction de comparaison définie par l’application pour trier les éléments d’un contrôle list-view. L’index de chaque élément change pour refléter la nouvelle séquence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro ListView_SortItemsEx .

Paramètres

wParam

Valeur définie par l’application passée à la fonction de comparaison.

lParam

Pointeur vers une fonction de comparaison définie par l’application. Il est appelé pendant l’opération de tri chaque fois que l’ordre relatif de deux éléments de liste doit être comparé.

Valeur retournée

Retourne TRUE si elle réussit ou FALSE dans le cas contraire.

Notes

La fonction de comparaison a la forme suivante :

int CALLBACK CompareFunc(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort);  

Ce message est similaire à LVM_SORTITEMS, sauf pour le type d’informations transmises à la fonction de comparaison. Avec LVM_SORTITEMSEX, lParam1 est l’index actuel du premier élément, et lParam2 est l’index actuel du deuxième élément. Vous pouvez envoyer un message LVM_GETITEMTEXT pour récupérer plus d’informations sur un élément, si nécessaire.

La fonction de comparaison doit retourner une valeur négative si le premier élément doit précéder le deuxième, une valeur positive si le premier élément doit suivre le deuxième ou zéro si les deux éléments sont équivalents.

Notes

Pendant le processus de tri, le contenu de l’affichage de liste est instable. Si la fonction de rappel envoie des messages au contrôle list-view en dehors de LVM_GETITEM (ListView_GetItem), les résultats sont imprévisibles.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2003 [applications de bureau uniquement]
En-tête
Commctrl.h