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	Winuser.h (termasuk Windows.h)

Baca juga

Referensi

WM_CHARTOITEM

Sumber Daya Lainnya

KATA SANDI

LOWORD

WM_KEYDOWN