macro ListView_SortItems (commctrl.h)

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 usar esta macro o enviar el mensaje LVM_SORTITEMS explícitamente.

Sintaxis

BOOL ListView_SortItems(
   HWND         hwndLV,
   PFNLVCOMPARE _pfnCompare,
   LPARAM       _lPrm
);

Parámetros

hwndLV

Tipo: HWND

Identificador del control list-view.

_pfnCompare

Tipo: PFNLVCOMPARE

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 se debe comparar el orden relativo de dos elementos de lista.

_lPrm

Tipo: LPARAM de

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

Valor devuelto

Tipo: BOOL de

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

Observaciones

La función de comparación tiene el siguiente formato.

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

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 lParam miembro del LVITEM de los elementos estructura cuando se insertaron en la lista. El parámetro _lPrm es el mismo valor que se pasa al mensaje LVM_SORTITEMS.

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.

Requisitos