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} אם קוד המקש הנתון כבר ממופה למקש קיצור.