Fungsi TranslateMessage (winuser.h)

  • Artikel

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)

Lihat juga