CListCtrl::SortItems
Seřadí položky seznamu zobrazení pomocí funkce porovnání definované aplikací.
BOOL SortItems(
PFNLVCOMPARE pfnCompare,
DWORD_PTR dwData
);
Parametry
[v]pfnCompare
Adresa funkce porovnání definované aplikací.Operace řazení volání funkce porovnání pokaždé, když potřebuje určuje relativní pořadí dvou položek seznamu.Porovnání funkce musí být statický člen třídy nebo samostatné funkce, která není členem žádné třídy.
[v]dwData
Hodnota definované aplikací, který je předán do funkce porovnání.
Vrácená hodnota
truePokud metoda úspěšná. jinak false .
Poznámky
Tato metoda změny indexu každé položky tak, aby odrážela nové pořadí.
Funkce porovnání pfnCompare , má následující tvar:
int CALLBACK CompareFunc(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort);
Porovnání funkce musí vracet zápornou hodnotu, pokud první položku mělo předcházet druhé, kladná hodnota, pokud první položka má následovat druhý nebo nula Pokud dvě položky jsou stejné.
lParam1 Parametr je 32bitová hodnota přidružená k první položku, která je porovnána a lParam2 parametr je hodnota spojená s druhou položkou.Jsou hodnoty, které byly zadány v lParam člen položek LVITEM struktury, když byly vloženy do seznamu. lParamSort Parametr je stejné jako dwData hodnotu.
Tato metoda odesílá LVM_SORTITEMS zprávy, která je popsána v .
Příklad
Je jednoduché srovnání funkci, která je výsledkem položky jsou seřazeny podle jejich lParam hodnoty.
// Sort items by associated lParam
int CALLBACK CListCtrlDlg::MyCompareProc(LPARAM lParam1, LPARAM lParam2,
LPARAM lParamSort)
{
UNREFERENCED_PARAMETER(lParamSort);
return (int)(lParam1 - lParam2);
}
// Sort the items by passing in the comparison function.
void CListCtrlDlg::Sort()
{
m_myListCtrl.SortItems(&CListCtrlDlg::MyCompareProc, 0);
}
Požadavky
Záhlaví: afxcmn.h
Tento ovládací prvek je podporován v systému Windows NT 3.51 nebo vyšší.