LVM_SORTITEMSEX pesan

  • Artikel

Menggunakan fungsi perbandingan yang ditentukan aplikasi untuk mengurutkan item kontrol tampilan daftar. Indeks setiap item berubah untuk mencerminkan urutan baru. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro ListView_SortItemsEx .

Parameter

wParam

Nilai yang ditentukan aplikasi yang diteruskan ke fungsi perbandingan.

lParam

Penunjuk ke fungsi perbandingan yang ditentukan aplikasi. Ini dipanggil selama operasi pengurutan setiap kali urutan relatif dari dua item daftar perlu dibandingkan.

Nilai kembali

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya.

Keterangan

Fungsi perbandingan memiliki formulir berikut:

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

Pesan ini mirip dengan LVM_SORTITEMS, kecuali untuk jenis informasi yang diteruskan ke fungsi perbandingan. Dengan LVM_SORTITEMSEX, lParam1 adalah indeks saat ini dari item pertama, dan lParam2 adalah indeks saat ini dari item kedua. Anda dapat mengirim pesan LVM_GETITEMTEXT untuk mengambil informasi lebih lanjut tentang item, jika diperlukan.

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.

Catatan

Selama proses pengurutan, konten tampilan daftar tidak stabil. Jika fungsi panggilan balik mengirim pesan apa pun ke kontrol tampilan daftar selain dari LVM_GETITEM (ListView_GetItem), hasilnya tidak dapat diprediksi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
 Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung
 Windows Server 2003 [hanya aplikasi desktop]
Header
Commctrl.h