macro ListView_SortItems (commctrl.h)

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

Sintassi

void ListView_SortItems(
   hwndLV,
   _pfnCompare,
   _lPrm
);

Parametri

hwndLV

Tipo: HWND

Handle per il controllo visualizzazione elenco.

_pfnCompare

Tipo: PFNLVCOMPARE

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 dell'elenco.

_lPrm

Tipo: LPARAM

Valore definito dall'applicazione passato alla funzione di confronto.

Valore restituito

nessuno

Osservazioni

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 lParamSort è lo stesso valore passato al messaggio LVM_SORTITEMS .

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 visualizzazione elenco, i risultati sono imprevedibili.

 

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	commctrl.h