WM_UNICHAR pesan

  • Artikel

Pesan WM_UNICHAR dapat digunakan oleh aplikasi untuk memposting input ke jendela lain. Pesan ini berisi kode karakter tombol yang ditekan. (Uji apakah aplikasi target dapat memproses pesan WM_UNICHAR dengan mengirim pesan dengan wParam diatur ke UNICODE_NOCHAR.)

#define WM_UNICHAR                      0x0109

Parameter

wParam

Kode karakter kunci.

Jika wParamUNICODE_NOCHAR dan aplikasi memproses pesan ini, kembalikan TRUE. Fungsi DefWindowProc akan mengembalikan FALSE (default).

Jika wParam tidak UNICODE_NOCHAR, kembalikan FALSE. Unicode DefWindowProc memposting pesan WM_CHAR dengan parameter yang sama dan fungsi ANSI DefWindowProc memposting satu atau dua pesan WM_CHAR dengan karakter ANSI yang sesuai.

lParam

Jumlah berulang, kode pemindaian, bendera extended-key, kode konteks, bendera status kunci sebelumnya, dan bendera status transisi, seperti yang ditunjukkan dalam tabel berikut.

Bit Makna
0-15 Jumlah pengulangan untuk pesan saat ini. Nilainya adalah berapa kali penekanan tombol di-autorepeated sebagai akibat dari pengguna yang menahan kunci. Jika penekanan tombol ditahan cukup lama, beberapa pesan akan dikirim. Namun, jumlah pengulangan tidak kumulatif.
16-23 Kode pemindaian. Nilainya tergantung pada OEM.
24 Menunjukkan apakah kunci adalah kunci yang diperluas, seperti tombol ALT dan CTRL kanan yang muncul pada keyboard 101- atau 102-tombol yang disempurnakan. Nilainya adalah 1 jika merupakan kunci yang diperluas; jika tidak, itu adalah 0.
25-28 Dipesan; jangan gunakan.
29 Kode konteks. Nilainya adalah 1 jika tombol ALT ditahan saat tombol ditekan; jika tidak, nilainya adalah 0.
30 Status kunci sebelumnya. Nilainya adalah 1 jika kunci tidak berfungsi sebelum pesan dikirim, atau 0 jika kunci naik.
31 Status transisi. Nilainya adalah 1 jika kunci sedang dirilis, atau 0 jika tombol sedang ditekan.

Untuk detail selengkapnya, lihat Bendera Pesan Keystroke.

Nilai kembali

Aplikasi harus mengembalikan nol jika memproses pesan ini.

Keterangan

Pesan WM_UNICHAR mirip dengan WM_CHAR, tetapi menggunakan Unicode Transformation Format (UTF)-32, sedangkan WM_CHAR menggunakan UTF-16.

Pesan ini dirancang untuk mengirim atau memposting karakter Unicode ke jendela ANSI dan dapat menangani karakter Bidang Tambahan Unicode.

Karena belum tentu ada korespondensi satu-ke-satu antara tombol yang ditekan dan pesan karakter yang dihasilkan, informasi dalam kata urutan tinggi parameter lParam umumnya tidak berguna untuk aplikasi. Informasi dalam kata urutan tinggi hanya berlaku untuk pesan WM_KEYDOWN terbaru yang mendahului postingan pesan WM_UNICHAR .

Untuk keyboard 101 dan 102 tombol yang disempurnakan, tombol yang diperluas adalah ALT kanan dan tombol CTRL kanan pada bagian utama keyboard; tombol INS, DEL, HOME, END, PAGE UP, PAGE DOWN dan panah di kluster di sebelah kiri keypad numerik; dan tombol bagi (/) dan ENTER di keypad numerik. Beberapa keyboard lain mungkin mendukung bit extended-key dalam parameter lParam .

Persyaratan

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

Lihat juga