הפונקציה MapVirtualKeyEx מתרגם (מפות) וירטואלי-מפתח קוד ערך סריקה של קוד או תו, או מתרגם קוד סריקה קוד מקש וירטואלי. הפונקציה מתרגם את קודי השימוש את שפת הקלט ואת פריסת לוח המקשים הפיזי שזיהה את נקודת האחיזה של פריסת לוח המקשים נתון.
(UINT MapVirtualKeyEx UINT uCode, / / מקש וירטואלי קוד קוד או סרוקUINTuMapType, / / תרגום לביצועHKLdwhkl / / נקודת האחיזה של פריסת לוח מקשים);
| ערך | משמעות |
|---|---|
| 0 | uCode הוא קוד מקש וירטואלי, מתורגם קוד סריקה. אם קוד מקש וירטואלי אינו מבחין בין המפתחות משמאל - ו ימינה - יד, מוחזר קוד סריקה שמאלי. אם לא תרגום, הפונקציה מחזירה 0. |
| 1 | uCode הוא קוד סריקה, מתורגם קוד מקש וירטואלי אינו מבחין בין שמאל - ו ימינה - יד מפתחות. אם לא תרגום, הפונקציה מחזירה 0. |
| 2 | uCode הוא קוד מקש וירטואלי, מתורגם ערך תו unshifted את המילה סדר נמוכה של הערך המוחזר. מת מפתחות (ניקוד) מצוינות על-ידי הגדרת סיבית העליון של הערך המוחזר. אם לא תרגום, הפונקציה מחזירה 0. |
| 3 | uCode הוא קוד סריקה, מתורגם קוד מקש וירטואלי המבדיל בין שמאל - ו ימינה - יד מפתחות. אם לא תרגום, הפונקציה מחזירה 0. |
הערך המוחזר הוא קוד סריקה, קוד מקש וירטואלי או ערך תו, בהתאם לערך של uCode ושל uMapType. אם לא תרגום, הערך המוחזר הוא אפס.
ליישום יש אפשרות להשתמש MapVirtualKeyEx כדי לתרגם קודי סריקה כדי קבועים קוד מקש וירטואלי VK_SHIFT VK_CONTROL, VK_MENU, ולהיפך. תרגומים אלו אינם מבחינים בין מופעים שמאלה וימינה shift, ctrl, או מקשי alt. יישום לקבל קוד הסריקה המתאים למופע השמאלי או הימני של אחד ממפתחות אלה על-ידי קריאה MapVirtualKeyEx uCode מוגדר באחד הקבועים הבאים של קוד מקש וירטואלי.
| VK_LSHIFT | VK_RSHIFT |
| VK_LCONTROL | VK_RCONTROL |
| VK_LMENU | VK_RMENU |
בקבועים אלה הבחנה משמאל לימין זמינים ליישום רק דרך GetKeyboardState, SetKeyboardState, GetAsyncKeyState, GetKeyState, MapVirtualKeyו MapVirtualKeyEx פונקציות. רשימה בטבלה מלאה וירטואלי קודי מפתח, ראה קודי וירטואלי-מפתח.
nbsp; Windows &NT: מחייב גירסה 4.0 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:לא נתמך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows NT.
מבט כולל על לוח המקשים קלט, בפונקציות קלט של לוח מקשים, GetAsyncKeyState, GetKeyboardState, GetKeyState, LoadKeyboardLayout, MapVirtualKey, SetKeyboardState