blockly‏ > ShortcutRegistry

הכיתה ShortcutRegistry

הכיתה של הרישום של מקשי הקיצור. הרכיב הזה מיועד להיות מופע יחיד. אין ליצור מופע חדש, ואפשר לגשת לכיתה הזו רק מ-ShortcutRegistry.registry.

Signature:

export declare class ShortcutRegistry 

מאפיינים

נכס	גורמי שינוי	סוג	תיאור
registry	static readonly	ShortcutRegistry

Methods

שיטה	גורמי שינוי	תיאור
addKeyMapping(keyCode, shortcutName, allowCollision)		הוספת מיפוי בין קוד מקש לבין מקשי קיצור. בדרך כלל אפשר למפות רק מקשי קיצור אחד לכל קוד מקש נתון, אבל הגדרת allowCollisions כ-true מאפשרת למפות מקלדת למספר מקשי קיצור. במקרה כזה, כשמתבצעת קריאה ל-onKeyDown עם הקשה נתונה, היא מעבדת את מקשי הקיצור הממופים בסדר הפוך, מהממופים לאחרונה ועד לממופים לפני הכי הרבה זמן).
createSerializedKey(keyCode, modifiers)		יצירת קוד המפתח בסריאליזציה שישמש במפת המפתחות.
getKeyCodesByShortcutName(shortcutName)		הפונקציה מקבלת את קודי המפתחות בסריאליזציה שבהם רשום קיצור הדרך עם השם הנתון.
getKeyMap()		אחזור של מפת המפתחות הנוכחית.
getRegistry()		אחזור של הרישום של מקשי הקיצור.
getShortcutNamesByKeyCode(keyCode)		הפונקציה מקבלת את מקשי הקיצור הרשומים לקוד המפתח הנתון.
onKeyDown(workspace, e)		טיפול באירועים של הקשה על מקש. - כל KeyboardShortcut שממופים למפתחות שמפעילים את האירוע e יעברו עיבוד, לפי הסדר מהאירוע שנרשם לפני הכי הרבה זמן ועד לאירוע שנרשם לפני הכי מעט זמן. - אם preconditionFn של קיצור הדרך קיים, הוא יקרא. אם הפונקציה preconditionFn מחזירה את הערך false, הפונקציה callback של קיצור הדרך תידלג. העיבוד ימשיך עם קיצור הדרך הבא, אם יש כזה. - לאחר מכן תתבצע קריאה לפונקציה callback של קיצור הדרך. אם הפונקציה מחזירה את הערך true, העיבוד יסתיים ו-onKeyDown תחזיר את הערך true. אם הפונקציה מחזירה את הערך false, העיבוד ימשיך עם קיצור הדרך הבא, אם יש כזה. - אם כל מקשי הקיצור הרשומים למפתח הנתון עובדו בלי שאף אחד מהם החזיר true, הפונקציה onKeyDown תחזיר false.
register(shortcut, allowOverrides)		הרשמה של מקש קיצור.
removeAllKeyMappings(shortcutName)		הסרת כל מיפויי המפתחות של קיצור דרך בשם הנתון. האפשרות הזו שימושית כשמשנים את מיפויי המקשים שמוגדרים כברירת מחדל, וקודי המקשים שרשומים לקיצור הדרך לא ידועים.
removeKeyMapping(keyCode, shortcutName, quiet)		הסרת מיפוי בין קוד מקש לבין מקשי קיצור.
reset()‎		מנקים את המרשם ומפת המקשים ויוצרים אותם מחדש.
setKeyMap(newKeyMap)		הגדרת מפת המקשים. הגדרת מפת המפתחות תבטל את כל מיפויי המפתחות שמוגדרים כברירת מחדל.
unregister(shortcutName)		ביטול הרישום של מקשי קיצור שרשומים בשם הנתון. הפעולה הזו תסיר גם את כל מיפויי המפתחות שמפנים לקיצור הדרך הזה.