mensaje de WM_COMPAREITEM

Se envía para determinar la posición relativa de un nuevo elemento en la lista ordenada de un cuadro combinado dibujado por el propietario o un cuadro de lista. Cada vez que la aplicación agrega un nuevo elemento, el sistema envía este mensaje al propietario de un cuadro combinado o cuadro de lista creado con el estilo CBS_SORT o LBS_SORT .

WM_COMPAREITEM

    WPARAM wParam;
    LPARAM lParam; 

Parámetros

wParam

Especifica el identificador del control que envió el mensaje WM_COMPAREITEM .

lParam

Puntero a una estructura COMPAREITEMSTRUCT que contiene los identificadores y los datos proporcionados por la aplicación para dos elementos del cuadro combinado o de lista.

Valor devuelto

El valor devuelto indica la posición relativa de los dos elementos. Puede ser cualquiera de los valores que se muestran en la tabla siguiente.

Código devuelto Descripción
Valor
Significado
-1
El elemento 1 precede al elemento 2 en el orden ordenado.
0
Los elementos 1 y 2 son equivalentes en el orden ordenado.
1
El elemento 1 sigue el elemento 2 en el orden ordenado.

Observaciones

Cuando el propietario de un cuadro combinado o cuadro de lista dibujado por el propietario recibe este mensaje, el propietario devuelve un valor que indica cuáles de los elementos especificados por la estructura COMPAREITEMSTRUCT aparecerán antes del otro. Normalmente, el sistema envía este mensaje varias veces hasta que determina la posición exacta del nuevo elemento.

Si un procedimiento de cuadro de diálogo controla este mensaje, debe convertir el valor devuelto deseado en un BOOL y devolver el valor directamente. Se omite el valor DWL_MSGRESULT establecido por la función SetWindowLong .

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado
Winuser.h (incluye Windows.h)

Consulte también

Referencia

COMPAREITEMSTRUCT

Otros recursos

SetWindowLong