LVM_SORTITEMSEX message

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 qui est 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 LA valeur 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, à l’exception du 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 la vue 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.

Spécifications

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