GetKeyState

הפונקציה GetKeyState מאחזר את המצב של מקש וירטואלי שצוין. המצב מציין אם המפתח הוא למעלה, למטה, או לחוץ (on / off — מתחלפים כל הזמן לוחצים על המקש).

(GetKeyState קצר int  nVirtKey / / מקש וירטואלי קוד);

פרמטרים

nVirtKey: ציון מפתח וירטואלי. אם המפתח וירטואלי הרצוי הוא אות או ספרה (A עד Z, a עד z או 0 עד 9), nVirtKey יש להגדיר את ערך ASCII של תו זה. עבור מקשים אחרים, הוא חייב להיות קוד מקש וירטואלי.
אם נעשה שימוש בפריסת לוח מקשים שאינם בשפה האנגלית, מפתחות וירטואליים עם ערכים בטווח של ASCII A עד z ו- 0 עד 9 משמשים כדי לציין את רוב מקשי תווים. לדוגמה, פריסת לוח מקשים גרמנית, המפתח וירטואלי של ערך ASCII O (0x4F) מפנה למפתח "o", בעוד VK_OEM_1 מפנה המפתח "o עם אומלאוט".

להחזיר ערכים

הערך המוחזר מציין את המצב של מקש וירטואלי נתון, כדלקמן:

אם הסיבית הגבוהות הוא 1, המפתח נמצא למטה; אחרת, היא למעלה.
אם בסיבית הנמוכה הוא 1, המקש לחוץ. מפתח, כגון caps lock מקש לחוץ אם היא מופעלת. המפתח אינו מופעל, untoggled אם בסיבית הנמוכה היא 0. מקש דו-מצבי נורית מחוון (אם בכלל) בלוח המקשים תהיה כאשר המקש לחוץ, וביטול כאשר המפתח הוא untoggled.

הערות

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

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

כדי לאחזר מידע מצב עבור כל מפתחות וירטואליים, השתמש בפונקציה GetKeyboardState.

יישום יכול להשתמש בקבועים קוד מקש וירטואלי VK_SHIFT, VK_CONTROL ו- VK_MENU כערכים עבור הפרמטר nVirtKey . זה נותן את המצב של shift, ctrl, או מקשי alt ללא הבחנה בין שמאל וימין. ליישום יש אפשרות להשתמש גם הקבועים הבאים של קוד מקש וירטואלי כערכים עבור nVirtKey כדי להבחין בין המופעים השמאליים והימניים של מפתחות אלה.

VK_LSHIFT	VK_RSHIFT
VK_LCONTROL	VK_RCONTROL
VK_LMENU	VK_RMENU

בקבועים אלה הבחנה משמאל לימין זמינים ליישום רק דרך GetKeyboardState, SetKeyboardState, GetAsyncKeyState, GetKeyStateופונקציות MapVirtualKey.

חלונות CE: ניתן להשתמש בפונקציה GetKeyState רק לבדוק את המצב למטה את המקשים הבאים וירטואלי

VK_CONTROL

VK_SHIFT

VK_MENU

VK_LCONTROL

VK_LSHIFT

VK_LMENU

VK_RCONTROL

VK_RSHIFT

VK_RMENU

ניתן להשתמש GetKeyState רק לבדוק את מצב toggled של מפתח וירטואלית VK_CAPITAL.

QuickInfo

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

ראה גם

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

Index