messaggio LVM_SORTITEMS

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

Parametri

wParam

Valore definito dall'applicazione passato alla funzione di confronto.

lParam

Puntatore alla funzione di confronto definita dall'applicazione. La funzione di confronto viene chiamata durante l'operazione di ordinamento ogni volta che è necessario confrontare l'ordine relativo di due elementi di 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);

Il parametro lParam1 è il valore associato al primo elemento confrontato e il parametro lParam2 è il valore associato al secondo elemento. Questi sono i valori specificati nel membro lParam della struttura LVITEM degli elementi quando sono stati inseriti nell'elenco. Il parametro wParam del ListView_SortItems viene passato alla funzione di callback come terzo parametro.

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