messaggio LVM_SORTITEMSEX

Usa una funzione di confronto definita dall'applicazione per ordinare gli elementi di un controllo di visualizzazione elenco. L'indice di ogni elemento viene modificato in modo da riflettere la nuova sequenza. È possibile inviare questo messaggio in modo esplicito o usando la macro ListView_SortItemsEx .

Parametri

wParam

Valore definito dall'applicazione passato alla funzione di confronto.

lParam

Puntatore a una funzione di confronto definita dall'applicazione. Viene chiamato durante l'operazione di ordinamento ogni volta che è necessario confrontare l'ordine relativo di due elementi dell'elenco.

Valore restituito

Restituisce TRUE se ha esito positivo o FALSE in caso contrario.

Commenti

La funzione di confronto ha il formato seguente:

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

Questo messaggio è simile a LVM_SORTITEMS, ad eccezione del tipo di informazioni passate alla funzione di confronto. Con LVM_SORTITEMSEX, lParam1 è l'indice corrente del primo elemento e lParam2 è l'indice corrente del secondo elemento. È possibile inviare un messaggio di LVM_GETITEMTEXT per recuperare altre informazioni su un elemento, se necessario.

La funzione di confronto deve restituire un valore negativo se il primo elemento deve precedere il secondo, un valore positivo se il primo elemento deve seguire il secondo o zero se i due elementi sono equivalenti.

Nota

Durante il processo di ordinamento, il contenuto della visualizzazione elenco è instabile. Se la funzione di callback invia messaggi al controllo di visualizzazione elenco a parte da LVM_GETITEM (ListView_GetItem), i risultati sono imprevedibili.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	Commctrl.h