TranslateMessage

הפונקציה TranslateMessage מתרגם מקש וירטואלי הודעות להודעות תו. התו מוצבות הודעות לתור הודעה של הליך הקריאה, ניתן לקרוא הבא בשעה את הליך המשנה שיחות GetMessage או הפונקציה PeekMessage.

(BOOL TranslateMessage CONST MSG  * lpMsg / / כתובת של מבנה עם הודעה);
 

פרמטרים

lpMsg
מצביע למבנה MSG המכיל מידע ההודעה שאוחזר מתור הודעות של הליך המשנה הקורא באמצעות הפונקציה GetMessage או PeekMessage.

להחזיר ערכים

אם ההודעה מתורגם (כלומר, הודעה תו מוצב תור הודעות של הליך המשנה), ערך ההחזרה הוא שונה מאפס.

אם ההודעה היא WM_KEYDOWN, WM_KEYUP, WM_SYSKEYDOWN או WM_SYSKEYUP, ערך ההחזרה הוא שונה מאפס, תרגום.

אם ההודעה לא מתורגם (כלומר, הודעה תו לא פורסם לתור ההודעות של הליך המשנה), הערך המוחזר הוא אפס.

הערות

הפונקציה TranslateMessage אינה משנה את ההודעה הצביע על-ידי הפרמטר lpMsg.

WM_KEYDOWN , WM_KEYUP צירופי להפיק הודעה WM_CHAR או WM_DEADCHAR . WM_SYSKEYDOWN , WM_SYSKEYUP צירופי לייצר הודעה WM_SYSCHAR או WM_SYSDEADCHAR.

TranslateMessage מייצרת WM_CHAR הודעות רק עבור מפתחות הממופים תווי ASCII על-ידי מנהל ההתקן של לוח המקשים.

אם יישומים לעבד הודעות מקש וירטואלי עבור מטרה אחרת, שהן תלכנה אינם TranslateMessage. למשל, יישום לא תלכנה TranslateMessage אם הפונקציה TranslateAccelerator מחזירה ערך שאינו אפס.

חלונות CE: Windows CE אינו תומך קודי סריקה או דגלי מפתח מורחב, כך הוא אינו תומך את הערכים 16-24 בפרמטר lKeyData (lParam) של ההודעה WM_CHAR שנוצרו על-ידי הפונקציה TranslateMessage.

ניתן להשתמש TranslateMessage רק לתרגם את ההודעות שהתקבלו שיחות GetMessage או PeekMessage.

QuickInfo

nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:דורש גירסה 1.0 ואילך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.

ראה גם

הודעות ודיוקן תורי הודעות, הודעה ופונקציות תור הודעות, GetMessage, PeekMessage, TranslateAccelerator, WM_CHAR, WM_DEADCHAR, WM_KEYDOWN, WM_KEYUP, WM_SYSCHAR, WM_SYSDEADCHAR, WM_SYSKEYDOWN, WM_SYSKEYUP

Index