blockly > ShortcutRegistry > addKeyMapping
متد ShortcutRegistry.addKeyMapping()
نقشه برداری بین کد کلید و میانبر صفحه کلید اضافه می کند.
به طور معمول فقط یک میانبر را می توان به هر کد کلید مشخصی نگاشت، اما تنظیم allowCollisions روی true به صفحه کلید اجازه می دهد تا به چند میانبر نگاشت شود. در آن صورت، زمانی که onKeyDown با فشار دادن کلید داده شده فراخوانی می شود، میانبرهای نقشه برداری شده را به ترتیب معکوس پردازش می کند، از بیشترین تا کمترین نقشه اخیر.
امضا:
addKeyMapping(keyCode: string | number | KeyCodes, shortcutName: string, allowCollision?: boolean): void;
پارامترها
پارامتر | تایپ کنید | توضیحات |
---|---|---|
کد کلید | رشته | شماره | کدهای کلیدی | کد کلید میانبر صفحه کلید. در صورت ثبت کد کلید با یک اصلاح کننده (مثلاً ctrl+c) از ShortcutRegistry.registry.createSerializedKey استفاده کنید. |
نام میانبر | رشته | نام میانبری که باید با فشار دادن کد کلید داده شده اجرا شود. |
اجازه برخورد | بولی | (اختیاری) درست برای جلوگیری از خطا هنگام افزودن میانبر به کلیدی که قبلاً به میانبر نگاشت شده است. |
برمی گرداند:
باطل
استثنائات
{ خطا } اگر کد کلید داده شده قبلاً به یک میانبر نگاشت شده باشد.