CListCtrl::SortItems
Uygulama tanımlı karşılaştırma işlevini kullanarak liste görünümü öğeleri sıralar.
BOOL SortItems(
PFNLVCOMPARE pfnCompare,
DWORD_PTR dwData
);
Parametreler
[in]pfnCompare
Uygulama tanımlı karşılaştırma işlev adresi.Sıralama işlemi, her zaman göreli iki liste öğelerinin sırasını belirlenmesi gereken karşılaştırma işlevini çağırır.Karşılaştırma işlevi, herhangi bir sınıfın üyesi olmayan tek başına bir işlev ya da statik bir sınıf üyesi olması gerekir.
[in]dwData
Karşılaştırma işlevine geçirilen uygulama tanımlı değeri.
Dönüş Değeri
trueyoksa yöntem başarılı; Aksi halde false.
Notlar
Bu yöntem yeni sırayı yansıtacak şekilde her öğenin dizini değiştirir.
Karşılaştırma işlevi pfnCompare, aşağıdaki biçime sahiptir:
int CALLBACK CompareFunc(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort);
İlk öğeyi ikinci gelmelidir, karşılaştırma işlevi negatif bir değer döndürmesi gerekir, ilk öğeyi ikinci ya da sıfır izlesin, pozitif bir değer iki eşit maddelerdir.
lParam1 32-Bit değeri karşılaştırılır, ilk öğe ile ilişkilendirilen bir parametredir ve lParam2 parametresi, ikinci öğe ile ilişkilendirilen değerdir.Bunlar içinde belirtilen değerlerdir lParam maddelerin üye LVITEM yapı listesine eklendiği zaman.lParamSort Parametresi ile aynı dwData değeri.
Bu yöntem gönderir LVM_SORTITEMS 'de açıklanan iletiyi Windows SDK.
Örnek
Aşağıdaki göre sıralanmış öğeler ile sonuçlanan bir basit karşılaştırma işlevidir kendi lParam değerler.
// 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);
}
Gereksinimler
Başlık: afxcmn.h
Bu denetim altında Windows NT 3.51 veya sonraki sürümlerde desteklenir.