TranslateMessage

De TranslateMessage functie vertaalt virtuele-kernboodschappen in karakter-berichten. De berichten zijn gepost naar de berichtenwachtrij van de aanroepende thread, te lezen de volgende teken tijd de draad oproepen de GetMessage of PeekMessage functie.

BOOL TranslateMessage ()  CONST MSG  * lpMsg / / adres van structuur met bericht);
 

Parameters

lpMsg
Pointer naar een MSG -structuur die berichtinformatie bevat ontvangen van berichtenwachtrij van de aanroepende thread met behulp van de functie GetMessage of PeekMessage.

Retourwaarden

Als het bericht wordt vertaald (dat wil zeggen, een teken bericht is gepost van de thread berichtenwachtrij), de retourwaarde is aan nul.

Als het bericht WM_KEYDOWN, WM_KEYUP, WM_SYSKEYDOWN of WM_SYSKEYUP is, is de retourwaarde aan nul, ongeacht de vertaling.

Als het bericht is niet vertaald (dat wil zeggen, een teken bericht is niet gepost van de thread berichtenwachtrij), de retourwaarde is nul.

Opmerkingen

De functie TranslateMessage wijzigt niet het bericht waarnaar door de parameter lpMsg.

WM_KEYDOWN en WM_KEYUP combinaties produceren een WM_CHAR of WM_DEADCHAR -bericht. WM_SYSKEYDOWN en WM_SYSKEYUP combinaties produceren een WM_SYSCHAR of WM_SYSDEADCHAR -bericht.

TranslateMessage produceert WM_CHAR berichten alleen voor sleutels die zijn toegewezen aan ASCII-tekens door het stuurprogramma voor het toetsenbord.

Als toepassingen virtuele-Kernboodschappen voor een ander doel verwerken, moeten ze niet TranslateMessagenoemen. Bijvoorbeeld, moet een toepassing TranslateMessage niet bellen als de functie TranslateAccelerator een andere waarde dan nul retourneert.

Windows CE: Windows CE ondersteunt geen scan codes of uitgebreide belangrijke vlaggen, zodat de waarden 16-24 wordt niet ondersteund in de lKeyData -parameter (lParam) van het WM_CHAR bericht gegenereerd door de functie TranslateMessage.

TranslateMessage kan alleen worden gebruikt voor het vertalen berichten ontvangen van oproepen naar GetMessage of PeekMessage.

Syntaxisinfo

nbsp; Windows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Versie 1.0 of hoger vereist.
Header:Verklaard in winuser.h.
Bibliotheek importeren:User32.lib gebruiken.

Zie ook

Berichten en bericht wachtrijen overzicht, bericht en bericht wachtrij functies, GetMessage, PeekMessage, TranslateAccelerator, WM_CHAR, WM_DEADCHAR, WM_KEYDOWN, WM_KEYUP, WM_SYSCHAR, WM_SYSDEADCHAR, WM_SYSKEYDOWN, WM_SYSKEYUP

Index