הפונקציה TranslateAccelerator מעבד מקשי האצה עבור פקודות תפריט. הפונקציה מתרגם WM_KEYDOWN או הודעה WM_SYSKEYDOWN הודעה WM_COMMAND או WM_SYSCOMMAND (אם קיים ערך עבור המפתח בטבלה שצוינה האצה) ולאחר מכן שולח WM_COMMAND או WM_SYSCOMMAND הודעה ישירות על הפרוצדורה של החלון המתאים. TranslateAccelerator אינו חוזר עד בהליך חלון עיבד את ההודעה.
int TranslateAccelerator ( HWND hWnd, / / לטפל לחלון היעדHACCELhAccTable, / / לטפל לטבלה האצהLPMSGlpMsg / / כתובת של מבנה עם הודעה);
אם הפונקציה מצליחה, הערך המוחזר אינו אפס.
אם הפעולה תיכשל, הערך המוחזר הוא אפס. כדי לקבל מידע שגיאות מורחב, לקרוא GetLastError.
כדי להבחין בין הודעת פונקציה זו שולחת מהודעות שנשלחו על-ידי תפריטים או פקדים, המילה הגבוהות של הפרמטר wParam WM_COMMAND או WM_SYSCOMMAND ההודעה מכיל את הערך 1.
צירופי מקשים מאיץ שמשמש לבחירת פריטים מתפריט חלון תורגמו ל הודעות WM_SYSCOMMAND; כל מאיץ בצירופי מקשים אחרים תורגמו ל WM_COMMAND הודעות.
כאשר TranslateAccelerator מחזירה ערך שאינו אפס ואת ההודעה מתורגם, היישום אין להשתמש בפונקציה TranslateMessage כדי לעבד את ההודעה שוב.
צריך במאיץ לא יתאימו לפקודת תפריט.
אם הפקודה האצה מתאים פריט בתפריט, היישום נשלח הודעות WM_INITMENU ו- WM_INITMENUPOPUP , כאילו המשתמש ניסו להציג את התפריט. עם זאת, הודעות אלה לא יישלחו אם מתקיים אחד מהתנאים הבאים:
אם החלון שצוין הוא החלון הפעיל ללא חלון יש מוקד לוח מקשים (שהוא בדרך כלל במקרה אם החלון ממוזער), TranslateAccelerator מתרגם WM_SYSKEYUP והודעות WM_SYSKEYDOWN במקום WM_KEYUP ו WM_KEYDOWN הודעות.
אם הקשה מקש האצה מתרחשת המתאים פריט התפריט כאשר חלון הנמצאים בבעלות על התפריט ממוזער, TranslateAccelerator אינו שולח הודעה WM_COMMAND. עם זאת, במקרה מקש האצה שאינה תואמת הפריטים בתפריט של החלון או בתפריט חלון , הפונקציה שולח הודעה WM_COMMAND, גם אם החלון ממוזער.
חלונות CE: כל ההודעות מקש האצה תורגמו ל הודעות WM_COMMAND; Windows CE אינו תומך את ההודעה WM_SYSCOMMAND.
nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:דורש גירסה 1.0 ואילך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows NT.
מבט כולל על לוח המקשים מאיצים, פונקציות מקש האצה בלוח המקשים, CreateAcceleratorTable, GetMessage, LoadAccelerators, MSG, PeekMessage, SetCapture, TranslateMessage, WM_COMMAND, WM_INITMENU, WM_INITMENUPOPUP, WM_KEYDOWN, WM_SYSKEYDOWN, WM_SYSCOMMAND