macro ListView_SortItems (commctrl.h)

Articolo
10/24/2024

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

Sintassi

BOOL ListView_SortItems(
   HWND         hwndLV,
   PFNLVCOMPARE _pfnCompare,
   LPARAM       _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 di elenco.

_lPrm

Tipo: LPARAM

Valore definito dall'applicazione passato alla funzione di confronto.

Valore restituito

Tipo: BOOL

Restituisce TRUE in caso di esito positivo oppure FALSE in caso contrario.

Osservazioni

La funzione di confronto ha il formato seguente.

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

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 lParam membro della struttura LVITEM degli elementi quando sono stati inseriti nell'elenco. Il parametro _lPrm è lo stesso valore passato al messaggio di 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.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	commctrl.h

Condividi tramite