ListView_SortItems macro (commctrl.h)

Article
08/22/2023

Utilise une fonction de comparaison définie par l’application pour trier les éléments d’un contrôle d’affichage de liste. L’index de chaque élément change pour refléter la nouvelle séquence. Vous pouvez utiliser cette macro ou envoyer le message LVM_SORTITEMS explicitement.

Syntaxe

void ListView_SortItems(
   hwndLV,
   _pfnCompare,
   _lPrm
);

Paramètres

hwndLV

Type : HWND

Handle pour le contrôle d’affichage de liste.

_pfnCompare

Type : PFNLVCOMPARE

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é.

_lPrm

Type : LPARAM

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

Valeur de retour

None

Remarques

La fonction de comparaison se présente sous 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 qui ont été spécifiées dans le membre lParam de la structure LVITEM des éléments lorsqu’ils ont été insérés dans la liste. Le paramètre lParamSort est la même valeur passée au message LVM_SORTITEMS .

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 second, ou zéro si les deux éléments sont équivalents.

Note 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, 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]
Plateforme cible	Windows
En-tête	commctrl.h

Partager via