GetAsyncKeyState

הפונקציה GetAsyncKeyState קובעת אם מפתח הוא למעלה או למטה בזמן שהפונקציה נקראת, אם המפתח היה לחוץ לאחר הקריאה הקודם ל- GetAsyncKeyState.

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

פרמטרים

vKey
ציון אחד מהקודים מקש וירטואלי אפשרי 256. לקבלת מידע נוסף, ראה קודי וירטואלי-מפתח.

Windows NT: באפשרותך להשתמש בקבועים הבחנה משמאל לימין כדי לציין מסוימים בלוח המקשים. עיין בסעיף הערות למידע נוסף.

להחזיר ערכים

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

Windows 95: Windows 95 אינו תומך קבועים הבחנה משמאל לימין. אם תקרא GetAsyncKeyState בקבועים אלה, הערך המוחזר הוא אפס.

הערות

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

GetSystemMetrics(SM_SWAPBUTTON) 

 

אשר מחזירה TRUE אם שהחלפת לחצני העכבר.

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

Windows NT: ניתן להשתמש בקבועים קוד מקש וירטואלי הבאים כערכים עבור vKey כדי להבחין בין המופעים השמאליים והימניים של מפתחות אלה.

קוד משמעות
VK_LSHIFT VK_RSHIFT
VK_LCONTROL VK_RCONTROL
VK_LMENU VK_RMENU

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

חלונות CE: הפונקציה GetAsyncKeyState תומך הקבועים מפתח וירטואלי לימין ולשמאל, כך שתוכל לקבוע אם היה נלחץ על המקש השמאלי או במקש הימני. בקבועים אלה הם VK_LCONTROL VK_RCONTROL, VK_LMENU, VK_RMENU, VK_LSHIFT, VK_RSHIFT.

הסיבית המשמעותית ביותר של הערך המוחזר הוא לא חוקי ב- Windows CE, יש להתעלם.

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

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

QuickInfo

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

ראה גם

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

Index