ListView_SortItems makro (commctrl.h)
Menggunakan fungsi perbandingan yang ditentukan aplikasi untuk mengurutkan item kontrol tampilan daftar. Indeks setiap item berubah untuk mencerminkan urutan baru. Anda bisa menggunakan makro ini atau mengirim pesan LVM_SORTITEMS secara eksplisit.
Sintaks
void ListView_SortItems(
hwndLV,
_pfnCompare,
_lPrm
);
Parameter
hwndLV
Jenis: HWND
Handel ke kontrol tampilan daftar.
_pfnCompare
Jenis: PFNLVCOMPARE
Penunjuk ke fungsi perbandingan yang ditentukan aplikasi. Fungsi perbandingan dipanggil selama operasi pengurutan setiap kali urutan relatif dari dua item daftar perlu dibandingkan.
_lPrm
Jenis: LPARAM
Nilai yang ditentukan aplikasi yang diteruskan ke fungsi perbandingan.
Mengembalikan nilai
Tidak ada
Keterangan
Fungsi perbandingan memiliki formulir berikut.
int CALLBACK CompareFunc(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort);
Parameter lParam1 adalah nilai yang terkait dengan item pertama yang dibandingkan; dan parameter lParam2 adalah nilai yang terkait dengan item kedua. Ini adalah nilai yang ditentukan dalam anggota lParam dari struktur LVITEM item ketika disisipkan ke dalam daftar. Parameter lParamSort adalah nilai yang sama yang diteruskan ke pesan LVM_SORTITEMS .
Fungsi perbandingan harus mengembalikan nilai negatif jika item pertama harus mendahului yang kedua, nilai positif jika item pertama harus mengikuti item kedua, atau nol jika dua item tersebut setara.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | commctrl.h |