winuser.h

Mensaje WM_COMPAREITEM

Definición

WM_COMPAREITEM  
idCtl = wParam;                        // identificador de control
lpcis = (LPCOMPAREITEMSTRUCT) lParam;  // estructura con items

Windows envía un mensaje WM_COMPAREITEM para determinar la posición relativa de un nuevo ítem en una lista ordenada de un combo box o list box owner-drawn. Cada vez que la aplicación añade un nuevo ítem, Windows envía este mensaje a la ventana propietaria del combo box o list box creado con el estilo CBS_SORT o LBS_SORT.

Descripción

idCtl: valor de wParam. Especifica el identificador del control que envía el mensaje WM_COMPAREITEM.

lpcis: valor de lParam. Apunta a una estructura COMPAREITEMSTRUCT que contiene los identificadores y los datos suministrados por la aplicación para los dos ítems en el combo box o list box.

Valor de retorno

El valor de retorno indica la posición relativa de los dos ítems. Puede ser cualquiera de los siguientes valores:

Valor Significado
-1 El ítem 1 precede al ítem 2 según el orden definido.
0 Los ítems 1 y 2 son equivalentes según el orden definido.
1 El ítem 1 sigue al ítem 2 según el orden definido.

Observaciones

Cuando la ventana propietaria de un combo box o list box owner-drawn recibe este mensaje, devolverá un valor indicando cual de los ítems especificados por la estructura COMPAREITEMSTRUCT debe aparecer antes del otro. Generalmente, Windows envía este mensaje varias veces hasta determinar la posición exacta para el nuevo ítem.