RegisterHotKey

הפונקציה RegisterHotKey מגדיר מקש קיצור-מערכתית.

(BOOL RegisterHotKey HWND  hWnd, / / חלון כדי לקבל דיווח על מקש חםint id, / / המזהה של מקש קיצורUINTfsModifiers, / / דגלי מקש צירוףUINTvk / / מקש וירטואלי קוד);
 

פרמטרים

hWnd

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

מזהה

קביעת המזהה של מקש קיצור. אין מקש קיצור אחרים ברצף הקריאה צריכה לקבל אותו מזהה. יישום עליך לציין ערך בטווח 0x0000 דרך 0xBFFF. ספריית קישור דינאמי (DLL) משותפת עליך לציין ערך בטווח 0xC000 דרך 0xFFFF (טווח שהחזיר הפונקציה GlobalAddAtom ). כדי למנוע התנגשויות עם מקש חם מזהים שהוגדרו על-ידי Dll משותפות אחרות, DLL עליך להשתמש בפונקציה GlobalAddAtom כדי להשיג את מזהה מפתח חמים.

fsModifiers

ציון מפתחות יש ללחוץ בשילוב עם המפתח שצוין על-ידי הפרמטר nVirtKey כדי ליצור את ההודעה WM_HOTKEY. הפרמטר fsModifiers יכול להיות שילוב של הערכים הבאים.

ערך	משמעות
MOD_ALT	יש להחזיק את מקש alt או.
MOD_CONTROL	יש להחזיק את מקש ctrl או.
MOD_SHIFT	יש להחזיק את מקש shift או.
MOD_WIN	מקש חלונות או נערכו. מפתחות אלה מסומנות בסמל Microsoft Windows.

vk

ציון קוד מקש וירטואלי של מקש קיצור.

להחזיר ערכים

אם הפונקציה מצליחה, הערך המוחזר אינו אפס.

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

הערות

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

לפונקציה זו אין אפשרות לשייך מקש קיצור חלון שנוצרו על-ידי הליך משנה אחר.

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

אם החלון המזוהה על-ידי הפרמטר hWnd כבר רשומים על מקש ישיר עם אותו מזהה כמו שצוין על-ידי הפרמטר id , הערכים החדשים עבור הפרמטרים fsModifiers ו- vk להחליף את הערכים שצוינו קודם לכן עבור פרמטרים אלה.

חלונות CE: בגירסאות Windows CE 2.0 או גירסה מתקדמת יותר תומך דגל נוסף, המכונה MOD_KEYUP, עבור הפרמטר fsModifiers . אם תגדיר את הדגל MOD_KEYUP, החלון תישלח הודעה WM_HOTKEY במפתח עד האירוע, כמו גם על מקש לחוץ אירוע.

ניתן להשתמש RegisterHotKey כדי לרשום מקשים חמים לאורך הליכי משנה.

QuickInfo

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

ראה גם

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

Index