הפונקציה GetKeyNameText אחזור מחרוזת המייצגת את השם של מפתח.
int GetKeyNameText ( רב lParam, / / שניה פרמטר של הודעה באמצעות לוח המקשיםLPTSTRlpString, / / מצביע למאגר עבור שם מפתחintnSize / / אורך מחרוזת האורך המרבי של שם מפתח);
| סיביות | משמעות |
|---|---|
| 16–23 | לסרוק קוד. |
| 24 | דגל מפתח מורחב. מבדיל מסוימים למקשים בלוח מקשים משופר. |
| 25 | "לא אכפת" סיביות. היישום קורא לפונקציה זו מגדירה סיבית זו כדי לציין כי הפונקציה יש הבחנה בין שמאל וימין ctrl ו- shift לחוצים, לדוגמה. |
אם הפונקציה מצליחה, מחרוזת המסתיימת ב- null מועתק אל תוך המאגר שצוין, הערך המוחזר הוא האורך של המחרוזת, בתווים, לא כולל את התו null סיום.
אם הפעולה תיכשל, הערך המוחזר הוא אפס. כדי לקבל מידע שגיאות מורחב, לקרוא GetLastError.
התבנית של מחרוזת שם מפתח תלויה פריסת לוח המקשים הנוכחית. מנהל ההתקן של לוח המקשים שומר רשימה של שמות בצורה של מחרוזות תווים עבור מפתחות עם שמות יותר מ תו בודד. שם המפתח מתורגם בהתאם לפריסת לוח המקשים המותקנות כעת. שם מפתח תו הוא התו עצמו. לאיית השמות של מפתחות המת במלואו.
nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:לא נתמך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows NT.
מבט כולל על לוח המקשים קלט, בפונקציות קלט של לוח מקשים