WM_COMPAREITEM message

Envoyé pour déterminer la position relative d’un nouvel élément dans la liste triée d’une zone de liste déroulante ou d’une zone de liste dessinée par le propriétaire. Chaque fois que l’application ajoute un nouvel élément, le système envoie ce message au propriétaire d’une zone de liste déroulante ou d’une zone de liste créée avec le style CBS_SORT ou LBS_SORT .

WM_COMPAREITEM

    WPARAM wParam;
    LPARAM lParam; 

Paramètres

wParam

Spécifie l’identificateur du contrôle qui a envoyé le message WM_COMPAREITEM .

lParam

Pointeur vers une structure COMPAREITEMSTRUCT qui contient les identificateurs et les données fournies par l’application pour deux éléments dans la zone de liste déroulante ou de liste.

Valeur retournée

La valeur de retour indique la position relative des deux éléments. Il peut s’agir de l’une des valeurs indiquées dans le tableau suivant.

Code de retour Description
Valeur
Signification
-1
L’élément 1 précède l’élément 2 dans l’ordre trié.
0
Les éléments 1 et 2 sont équivalents dans l’ordre trié.
1
L’élément 1 suit l’élément 2 dans l’ordre trié.

Notes

Lorsque le propriétaire d’une zone de liste déroulante ou d’une zone de liste dessinée par le propriétaire reçoit ce message, le propriétaire retourne une valeur indiquant les éléments spécifiés par la structure COMPAREITEMSTRUCT qui apparaîtront avant l’autre. En règle générale, le système envoie ce message plusieurs fois jusqu’à ce qu’il détermine la position exacte du nouvel élément.

Si une procédure de boîte de dialogue gère ce message, elle doit convertir la valeur de retour souhaitée en boOL et retourner la valeur directement. La valeur DWL_MSGRESULT définie par la fonction SetWindowLong est ignorée.

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
Winuser.h (inclure Windows.h)

Voir aussi

Référence

COMPAREITEMSTRUCT

Autres ressources

SetWindowLong