ListView_SortItems makro (commctrl.h)

Artikel
10/24/2024

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

Sintaksis

BOOL ListView_SortItems(
   HWND         hwndLV,
   PFNLVCOMPARE _pfnCompare,
   LPARAM       _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 dua item daftar perlu dibandingkan.

_lPrm

Jenis: LPARAM

Nilai yang ditentukan aplikasi yang diteruskan ke fungsi perbandingan.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya.

Komentar

Fungsi perbandingan memiliki formulir berikut.

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

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 lParam anggota struktur LVITEM item ketika dimasukkan ke dalam daftar. Parameter _lPrm 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.

Catatan Selama proses pengurutan, konten tampilan daftar tidak stabil. Jika fungsi panggilan balik mengirim pesan apa pun ke kontrol tampilan daftar, hasilnya tidak dapat diprediksi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	commctrl.h

Bagikan melalui