Partager via


LVM_SORTITEMS 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_SortItems .

Paramètres

wParam

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

lParam

Pointeur vers la fonction de comparaison définie par l’application. La fonction de comparaison est appelée 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);

Le paramètre lParam1 est la valeur associée au premier élément comparé, et le paramètre lParam2 est la valeur associée au deuxième élément. Il s’agit des valeurs spécifiées dans le membre lParam de la structure LVITEM des éléments lors de leur insertion dans la liste. Le paramètre wParam du ListView_SortItems est passé à la fonction de rappel en tant que troisième paramètre.

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