WM_COMPAREITEM pesan

  • Artikel

Dikirim untuk menentukan posisi relatif item baru dalam daftar yang diurutkan dari kotak kombo atau kotak daftar yang digambar pemilik. Setiap kali aplikasi menambahkan item baru, sistem mengirim pesan ini ke pemilik kotak kombo atau kotak daftar yang dibuat dengan gaya CBS_SORT atau LBS_SORT .

WM_COMPAREITEM

    WPARAM wParam;
    LPARAM lParam;

Parameter

wParam

Menentukan pengidentifikasi kontrol yang mengirim pesan WM_COMPAREITEM .

lParam

Arahkan ke struktur COMPAREITEMSTRUCT yang berisi pengidentifikasi dan data yang disediakan aplikasi untuk dua item dalam kotak kombo atau daftar.

Menampilkan nilai

Nilai yang dikembalikan menunjukkan posisi relatif dari dua item. Ini mungkin salah satu nilai yang diperlihatkan dalam tabel berikut.

Menampilkan kode Deskripsi
Nilai
 Makna
-1
 Item 1 mendahului item 2 dalam urutan yang diurutkan.
0
 Item 1 dan 2 setara dalam urutan yang diurutkan.
1
 Item 1 mengikuti item 2 dalam urutan yang diurutkan.

Keterangan

Ketika pemilik kotak kombo atau kotak daftar yang digambar pemilik menerima pesan ini, pemilik mengembalikan nilai yang menunjukkan item mana yang ditentukan oleh struktur COMPAREITEMSTRUCT yang akan muncul di hadapan yang lain. Biasanya, sistem mengirim pesan ini beberapa kali sampai menentukan posisi yang tepat untuk item baru.

Jika prosedur kotak dialog menangani pesan ini, itu harus mentransmisikan nilai pengembalian yang diinginkan ke BOOL dan mengembalikan nilai secara langsung. Nilai DWL_MSGRESULT yang ditetapkan oleh fungsi SetWindowLong diabaikan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
 Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung
 Windows Server 2003 [hanya aplikasi desktop]
Header
Winuser.h (termasuk Windows.h)

Lihat juga

Referensi

COMPAREITEMSTRUCT

Sumber Daya Lainnya

SetWindowLong