קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
blockly > ShortcutRegistry > addKeyMapping
השיטה ShortcutRegistry.addKeyMapping()
הוספת מיפוי בין קוד מקש לבין מקשי קיצור.
בדרך כלל אפשר למפות רק מקשי קיצור אחד לכל קוד מקש נתון, אבל הגדרת allowCollisions כ-true מאפשרת למפות מקלדת למספר מקשי קיצור. במקרה כזה, כשמתבצעת קריאה ל-onKeyDown עם הקשה נתונה, היא מעבדת את מקשי הקיצור הממופים בסדר הפוך, מהממופים לאחרונה ועד לממופים לפני הכי הרבה זמן).
Signature:
addKeyMapping(keyCode: string | number | KeyCodes, shortcutName: string, allowCollision?: boolean): void;
פרמטרים
| פרמטר |
סוג |
תיאור |
| keyCode |
מחרוזת | מספר | KeyCodes |
קוד המקש של מקש הקיצור. אם רוצים לרשום קוד מקש עם מקש שינוי (למשל: ctrl+c), צריך להשתמש ב-ShortcutRegistry.registry.createSerializedKey; |
| shortcutName |
מחרוזת |
השם של מקש הקיצור שיופעל כאשר מקישים על קוד המקש הנתון. |
| allowCollision |
בוליאני |
(אופציונלי) הערך True מונע שגיאה כשמוסיפים קיצור דרך למקש שכבר ממופה לקיצור דרך. |
החזרים:
לא תקף
חריגים
{Error} אם קוד המקש הנתון כבר ממופה למקש קיצור.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-07-25 (שעון UTC)."],[],["The `addKeyMapping` method in `ShortcutRegistry` establishes a link between a key code and a keyboard shortcut name. It takes the `keyCode` (string, number, or `KeyCodes` enum), the `shortcutName` (string), and an optional `opt_allowCollision` (boolean) parameter. It maps a key to a shortcut. If the key is already mapped and `opt_allowCollision` is false, it throws an error. Otherwise no error will be thrown. This method returns void.\n"]]
