pesan WM_VKEYTOITEM
Dikirim oleh kotak daftar dengan gaya LBS_WANTKEYBOARDINPUT kepada pemiliknya sebagai respons terhadap pesan WM_KEYDOWN.
WM_VKEYTOITEM
WPARAM wParam;
LPARAM lParam;
Parameter
-
wParam
-
LOWORD menentukan kode kunci virtual dari kunci yang ditekan pengguna. HIWORD menentukan posisi caret saat ini.
-
lParam
-
Tangani ke kotak daftar.
Nilai hasil
Nilai pengembalian menentukan tindakan yang dilakukan aplikasi sebagai respons terhadap pesan. Nilai pengembalian -2 menunjukkan bahwa aplikasi menangani semua aspek pemilihan item dan tidak memerlukan tindakan lebih lanjut oleh kotak daftar. (Lihat Komentar.) Nilai pengembalian -1 menunjukkan bahwa kotak daftar harus melakukan tindakan default sebagai respons terhadap penekanan tombol. Nilai pengembalian 0 atau lebih besar menentukan indeks item dalam kotak daftar dan menunjukkan bahwa kotak daftar harus melakukan tindakan default untuk penekanan tombol pada item yang ditentukan.
Keterangan
Nilai pengembalian -2 hanya valid untuk kunci yang tidak diterjemahkan ke dalam karakter oleh kontrol kotak daftar. Jika pesan WM_KEYDOWN diterjemahkan ke pesan WM_CHAR dan aplikasi memproses pesan WM_VKEYTOITEM yang dihasilkan sebagai akibat dari penekanan tombol, kotak daftar mengabaikan nilai pengembalian dan melakukan pemrosesan default untuk karakter tersebut). WM_KEYDOWN pesan yang dihasilkan oleh kunci seperti VK_UP, VK_DOWN, VK_NEXT, dan VK_PREVIOUS tidak diterjemahkan ke pesan WM_CHAR. Dalam kasus seperti itu, menjebak pesan WM_VKEYTOITEM dan mengembalikan -2 mencegah kotak daftar melakukan pemrosesan default untuk kunci tersebut.
Untuk menjebak kunci yang menghasilkan pesan karakter dan melakukan pemrosesan khusus, aplikasi harus mensubkelas kotak daftar, menjebak pesan WM_KEYDOWN dan WM_CHAR , dan memproses pesan dengan tepat dalam prosedur subkelas.
Keterangan sebelumnya berlaku untuk kotak daftar reguler yang dibuat dengan gaya LBS_WANTKEYBOARDINPUT. Jika kotak daftar digambar pemilik, aplikasi harus memproses pesan WM_CHARTOITEM.
Fungsi DefWindowProc mengembalikan -1.
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 | Value |
|---|---|
| Klien minimum yang didukung |
Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung |
Windows Server 2003 [hanya aplikasi desktop] |
| Header |
|
Baca juga
-
Referensi
-
Sumber Daya Lainnya