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	قيمة منطقية	(اختياري) صحيح لمنع حدوث خطأ عند إضافة اختصار إلى مفتاح سبق أن تم ربطه باختصار.

المرتجعات:

غير صالح

الاستثناءات

{خطأ} إذا سبق أن تم ربط رمز المفتاح المحدَّد باختصار.