GetKeyNameText

הפונקציה GetKeyNameText אחזור מחרוזת המייצגת את השם של מפתח.

int GetKeyNameText ( רב  lParam, / / שניה פרמטר של הודעה באמצעות לוח המקשיםLPTSTRlpString, / / מצביע למאגר עבור שם מפתחintnSize / / אורך מחרוזת האורך המרבי של שם מפתח);
 

פרמטרים

lParam
מציין את הפרמטר השני של ההודעה לוח מקשים (כגון WM_KEYDOWN) יעובדו. הפונקציה מפרש את החלקים הבאים של lParam.
סיביות משמעות
16–23 לסרוק קוד.
24 דגל מפתח מורחב. מבדיל מסוימים למקשים בלוח מקשים משופר.
25 "לא אכפת" סיביות. היישום קורא לפונקציה זו מגדירה סיבית זו כדי לציין כי הפונקציה יש הבחנה בין שמאל וימין ctrl ו- shift לחוצים, לדוגמה.

lpString
מצביע למאגר אשר יקבל את שם מפתח.
nSize
ציון אורך מרבי, תווים, שם המפתח, כולל התו null סיום. (פרמטר זה צריך להיות שווה לגודל המאגר הצביע על-ידי הפרמטר lpString ).

להחזיר ערכים

אם הפונקציה מצליחה, מחרוזת המסתיימת ב- null מועתק אל תוך המאגר שצוין, הערך המוחזר הוא האורך של המחרוזת, בתווים, לא כולל את התו null סיום.

אם הפעולה תיכשל, הערך המוחזר הוא אפס. כדי לקבל מידע שגיאות מורחב, לקרוא GetLastError.

הערות

התבנית של מחרוזת שם מפתח תלויה פריסת לוח המקשים הנוכחית. מנהל ההתקן של לוח המקשים שומר רשימה של שמות בצורה של מחרוזות תווים עבור מפתחות עם שמות יותר מ תו בודד. שם המפתח מתורגם בהתאם לפריסת לוח המקשים המותקנות כעת. שם מפתח תו הוא התו עצמו. לאיית השמות של מפתחות המת במלואו.

QuickInfo

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

ראה גם

מבט כולל על לוח המקשים קלט, בפונקציות קלט של לוח מקשים

Index