WM_SETHOTKEY

יישום שולח הודעה WM_SETHOTKEY חלון כדי לשייך החלון מקש קיצור. כאשר המשתמש לוחץ על מקש חם, המערכת מפעילה את החלון.

WM_SETHOTKEY wParam = (WPARAM) MAKEWORD (vkey, מרכיבים) / / קוד מקש וירטואלי, מרכיבים של חמים lParam מפתח = 0;                                   / / לא נמצא בשימוש; חייב להיות אפס

פרמטרים

vkey

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

ערך	משמעות
HOTKEYF_ALT	מקש ALT
HOTKEYF_CONTROL	מקש CTRL
HOTKEYF_EXT	מפתח מורחב
HOTKEYF_SHIFT	מקש shift

להחזיר ערכים

הערך המוחזר הוא אחד מהפעולות הבאות:

ערך	משמעות
– 1	הפונקציה אינה מצליחה — מקש קיצור לא חוקי.
..0	הפונקציה אינה מצליחה — החלון אינו חוקי.
..1	הפונקציה היא מוצלחת, אין חלון אחר בעל אותו מפתח חם.
..2	הפונקציה היא מוצלחת, אבל כבר יש חלון אחר באותו מפתח חם.

הערות

מקש קיצור לא ניתן לשייך חלון צאצא.

VK_ESCAPE, VK_SPACE ו- VK_TAB הם לא חוקי מקשי קיצור.

כאשר המשתמש לוחץ על מקש חם, המערכת יוצרת הודעה WM_SYSCOMMAND עם wParam שווה SC_HOTKEY ו- lParam שווה נקודת אחיזה של החלון. אם הודעה זו מועברת DefWindowProc, יביא המערכת האחרון הפעיל מוקפץ של החלון (אם היא קיימת) או את החלון עצמו (אם אין חלון מוקפץ) בקידמה.

חלון יכולים להיות רק אחד מקש קיצור. אם החלון כבר יש מקש קיצור משויך, מקש קיצור חדש מחליף את הישן. אם חלון אחד או יותר יש את אותו מפתח חם, החלון שבו מופעל על-ידי מקש קיצור הוא אקראי.

מקשי קיצור אלה אינם קשורים מקשי קיצור שנקבעו על-ידי RegisterHotKey.

QuickInfo

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

ראה גם

מבט כולל על לוח המקשים קלט, הודעות קלט של לוח מקשים, RegisterHotKey, WM_GETHOTKEY, WM_SYSCOMMAND

Index