mensaje de LVM_SORTITEMS

Usa una función de comparación definida por la aplicación para ordenar los elementos de un control de vista de lista. El índice de cada elemento cambia para reflejar la nueva secuencia. Puede enviar este mensaje explícitamente o mediante la macro ListView_SortItems .

Parámetros

wParam

Valor definido por la aplicación que se pasa a la función de comparación.

lParam

Puntero a la función de comparación definida por la aplicación. Se llama a la función de comparación durante la operación de ordenación cada vez que es necesario comparar el orden relativo de dos elementos de lista.

Valor devuelto

Devuelve TRUE si es correcto o FALSE en caso contrario.

Comentarios

La función de comparación tiene la forma siguiente:

int CALLBACK CompareFunc(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort);

El parámetro lParam1 es el valor asociado al primer elemento que se va a comparar y el parámetro lParam2 es el valor asociado al segundo elemento. Estos son los valores especificados en el miembro lParam de la estructura LVITEM de los elementos cuando se insertaron en la lista. El parámetro wParam del ListView_SortItems se pasa a la función de devolución de llamada como tercer parámetro.

La función de comparación debe devolver un valor negativo si el primer elemento debe preceder al segundo, un valor positivo si el primer elemento debe seguir el segundo o cero si los dos elementos son equivalentes.

Nota

Durante el proceso de ordenación, el contenido de la vista de lista es inestable. Si la función de devolución de llamada envía mensajes al control de vista de lista aparte de LVM_GETITEM (ListView_GetItem), los resultados son impredecibles.

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	Commctrl.h