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.