TranslateMessage

Funksjonen TranslateMessage oversetter virtual-key meldinger til tegn meldinger. Tegnet meldinger posteres til kallende trådens meldingskøen, for å lese neste tid tråden samtaler GetMessage eller PeekMessage -funksjonen.

BOOL TranslateMessage) CONST MSG  * lpMsg / / adresse av strukturen med melding);
 

Parametere

lpMsg
Peker til en MSG -struktur som inneholder meldingsinformasjon Hentet fra den kallende tråden meldingskøen ved hjelp av funksjonen GetMessage eller PeekMessage.

Returverdier

Hvis meldingen er oversatt (det vil si en tegn-melding posteres til trådens message queue), returverdien er ikke-null.

Hvis meldingen er WM_KEYDOWN, WM_KEYUP, WM_SYSKEYDOWN eller WM_SYSKEYUP, er returverdien ikke-null, uavhengig av oversettelsen.

Hvis meldingen ikke er oversatt (det vil si en tegn-melding ikke posteres til trådens message queue), returverdien er null.

Merknader

Funksjonen TranslateMessage endrer ikke meldingen vises til i lpMsg -parameteren.

WM_KEYDOWN og WM_KEYUP kombinasjoner produsere en WM_CHAR eller WM_DEADCHAR -melding. WM_SYSKEYDOWN og WM_SYSKEYUP kombinasjoner produsere en WM_SYSCHAR - eller WM_SYSDEADCHAR -melding.

TranslateMessage produserer WM_CHAR-meldinger bare for nøkler som er tilordnet til ASCII tegn ved tastaturdriveren.

Hvis programmer behandle virtual-key meldinger til noen annet formål, bør de ikke kalle TranslateMessage. For eksempel, bør ikke et program kaller TranslateMessage hvis funksjonen TranslateAccelerator returnerer en ikke-nullverdi.

Windows CE: Windows CE støtter ikke skanning koder eller utvidede viktige flagg, slik at det ikke støtter verdiene 16-24 i lKeyData -parameteren (lParam) for WM_CHAR-meldingen som genereres av TranslateMessage -funksjonen.

TranslateMessage kan bare brukes til å oversette meldinger mottatt fra kall til GetMessage eller PeekMessage.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Krever versjon 1.0 eller senere.
Topptekst:Deklarert i winuser.h.
Importere biblioteket:Bruk user32.lib.

Se også

Meldinger og melding køer oversikt, melding, og meldingen køen funksjoner, GetMessage, PeekMessage, TranslateAccelerator, WM_CHAR, WM_DEADCHAR, WM_KEYDOWN, WM_KEYUP, WM_SYSCHAR, WM_SYSDEADCHAR, WM_SYSKEYDOWN, WM_SYSKEYUP

Index