تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
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 |
قيمة منطقية |
(اختياري) صحيح لمنع حدوث خطأ عند إضافة اختصار إلى مفتاح سبق أن تم ربطه باختصار. |
المرتجعات:
غير صالح
الاستثناءات
{خطأ} إذا سبق أن تم ربط رمز المفتاح المحدَّد باختصار.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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 (حسب التوقيت العالمي المتفَّق عليه)"],[],["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"]]
