CListCtrl::SortItemsEx

Articolo
03/05/2013

Ordina gli elementi del controllo visualizzazione elenco corrente utilizzando una funzione di confronto definita dall'applicazione.

BOOL SortItemsEx(
     PFNLVCOMPARE pfnCompare, 
     DWORD_PTR dwData
);

Parametri

Parametro	Descrizione
[in] pfnCompare	L'indirizzo della funzione di confronto definita dall'applicazione. L'operazione di ordinamento chiama la funzione di confronto quando l'ordine relativo di due elementi elenco è necessario determinare da.La funzione di confronto deve essere un membro statico di una classe o una funzione autonoma che non è un membro di una classe.
[in] dwData	Valore definito da passato alla funzione di confronto.

[in] pfnCompare

L'indirizzo della funzione di confronto definita dall'applicazione.

L'operazione di ordinamento chiama la funzione di confronto quando l'ordine relativo di due elementi elenco è necessario determinare da.La funzione di confronto deve essere un membro statico di una classe o una funzione autonoma che non è un membro di una classe.

[in] dwData

Valore definito da passato alla funzione di confronto.

Valore restituito

true se questo metodo ha esito positivo; in caso contrario, false.

Note

Questo metodo modifica l'indice di ogni elemento per riflettere la nuova sequenza.

La funzione di confronto, pfnCompare, ha il formato seguente:

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

Questo messaggio è simile LVM_SORTITEMS, ad eccezione del tipo di dati passato alla funzione di confronto.In LVM_SORTITEMS, lParam1 e lParam2 sono i valori degli elementi da confrontare.In LVM_SORTITEMSEX, lParam1 è l'indice corrente del primo elemento da confrontare e lParam2 è l'indice corrente del secondo elemento.È possibile inviare un messaggio LVM_GETITEMTEXT per recuperare ulteriori informazioni su un elemento.

La funzione di confronto deve restituire un valore negativo se il primo elemento precede il secondo, un valore positivo se il primo elemento segue il secondo, o zero se i due elementi sono uguali.

[!NOTA]

Durante il processo di ordinamento, il contenuto della visualizzazione elenco sono instabili.Se la funzione di callback invia i messaggi al controllo elenco diverso da LVM_GETITEM, i risultati sono imprevedibili.

Questo metodo invia il messaggio LVM_SORTITEMSEX, come descritto in Windows SDK.

Requisiti

intestazione: afxcmn.h

Questo metodo è supportato in Windows 2000, Windows NT 4.0 con Internet Explorer 5, Windows 98 e versioni successive.

Esempio

Nell'esempio di codice definisce una variabile, m_listCtrl, utilizzata per accedere al controllo elenco corrente.Questa variabile viene utilizzata nell'esempio seguente.

public:
    // Variable used to access the list control.
    CListCtrl m_listCtrl;

Nell'esempio di codice riportato di seguito viene illustrato l'utilizzo del metodo SortItemEx.In una sezione precedente di questo esempio di codice, creato un controllo elenco che visualizza due colonne denominato "ClientID" e "conversione" in una visualizzazione report.Nell'esempio di codice ordina la tabella mediante i valori nella colonna "conversione".

// The ListCompareFunc() method is a global function used by SortItemEx().
int CALLBACK ListCompareFunc(
                             LPARAM lParam1, 
                             LPARAM lParam2, 
                             LPARAM lParamSort)
{
    CListCtrl* pListCtrl = (CListCtrl*) lParamSort;
    CString    strItem1 = pListCtrl->GetItemText(static_cast<int>(lParam1), 1);
    CString    strItem2 = pListCtrl->GetItemText(static_cast<int>(lParam2), 1);

    int x1 = _tstoi(strItem1.GetBuffer());
    int x2 = _tstoi(strItem2.GetBuffer());
    int result = 0;
    if ((x1 - x2) < 0)
        result = -1;
    else if ((x1 - x2) == 0)
        result = 0;
    else
        result = 1;

    return result;
}

void CCListCtrl_s2Dlg::OnBnClickedButton1()
{
    // SortItemsEx
    m_listCtrl.SortItemsEx( ListCompareFunc, (LPARAM)&m_listCtrl );
}