Fungsi TranslateMessage (winuser.h)
Menerjemahkan pesan kunci virtual ke dalam pesan karakter. Pesan karakter diposting ke antrean pesan utas panggilan, untuk dibaca saat berikutnya utas memanggil fungsi GetMessage atau PeekMessage .
Sintaks
BOOL TranslateMessage(
[in] const MSG *lpMsg
);
Parameter
[in] lpMsg
Jenis: const MSG*
Penunjuk ke struktur MSG yang berisi informasi pesan yang diambil dari antrean pesan utas panggilan dengan menggunakan fungsi GetMessage atau PeekMessage .
Nilai kembali
Jenis: BOOL
Jika pesan diterjemahkan (yaitu, pesan karakter diposting ke antrean pesan utas), nilai yang dikembalikan bukan nol.
Jika pesan WM_KEYDOWN, WM_KEYUP, WM_SYSKEYDOWN, atau WM_SYSKEYUP, nilai yang dikembalikan bukan nol, terlepas dari terjemahannya.
Jika pesan tidak diterjemahkan (yaitu, pesan karakter tidak diposting ke antrean pesan utas), nilai yang dikembalikan adalah nol.
Keterangan
Fungsi TranslateMessage tidak mengubah pesan yang diarahkan oleh parameter lpMsg .
Kombinasi WM_KEYDOWN dan WM_KEYUP menghasilkan pesan WM_CHAR atau WM_DEADCHAR . Kombinasi WM_SYSKEYDOWN dan WM_SYSKEYUP menghasilkan pesan WM_SYSCHAR atau WM_SYSDEADCHAR .
TranslateMessage menghasilkan WM_CHAR pesan hanya untuk kunci yang dipetakan ke karakter ASCII oleh driver keyboard.
Jika aplikasi memproses pesan kunci virtual untuk beberapa tujuan lain, aplikasi tersebut tidak boleh memanggil TranslateMessage. Misalnya, aplikasi tidak boleh memanggil TranslateMessage jika fungsi TranslateAccelerator mengembalikan nilai bukan nol. Perhatikan bahwa aplikasi bertanggung jawab untuk mengambil dan mengirimkan pesan input ke kotak dialog. Sebagian besar aplikasi menggunakan perulangan pesan utama untuk ini. Namun, untuk mengizinkan pengguna berpindah ke dan memilih kontrol dengan menggunakan keyboard, aplikasi harus memanggil IsDialogMessage. Untuk informasi selengkapnya, lihat Antarmuka Keyboard Kotak Dialog.
Contoh
Misalnya, lihat Membuat Perulangan Pesan.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Target Platform | Windows |
Header | winuser.h (termasuk Windows.h) |
Pustaka | User32.lib |
DLL | User32.dll |
Set API | ext-ms-win-ntuser-message-l1-1-0 (diperkenalkan dalam Windows 8) |