mensaje de LVM_SORTITEMSEX

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_SortItemsEx .

Parámetros

wParam

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

lParam

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

Valor devuelto

Devuelve TRUE si se ejecuta correctamente o FALSE de lo contrario.

Observaciones

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

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

Este mensaje es similar a LVM_SORTITEMS, excepto el tipo de información que se pasa a la función de comparación. Con LVM_SORTITEMSEX, lParam1 es el índice actual del primer elemento y lParam2 es el índice actual del segundo elemento. Puede enviar un mensaje de LVM_GETITEMTEXT para recuperar más información sobre un elemento, si es necesario.

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