blockly > ShortcutRegistry > addKeyMapping
เมธอด ShortcutRegistry.addKeyMapping()
เพิ่มการแมประหว่างรหัสคีย์กับแป้นพิมพ์ลัด
โดยปกติแล้ว แป้นพิมพ์ลัด 1 รายการจะแมปกับรหัสคีย์ใดก็ได้ แต่การตั้งค่า allowCollisions เป็น "จริง" จะช่วยให้แป้นพิมพ์แมปกับแป้นพิมพ์ลัดได้หลายรายการ ในกรณีนี้ เมื่อมีการเรียก onKeyDown ด้วยแป้นพิมพ์ที่กด ฟังก์ชันนี้จะประมวลผลแป้นพิมพ์ลัดที่แมปตามลำดับย้อนกลับจากแป้นพิมพ์ลัดที่แมปล่าสุดไปจนถึงแป้นพิมพ์ลัดที่แมปล่าสุดน้อยที่สุด)
ลายเซ็น:
addKeyMapping(keyCode: string | number | KeyCodes, shortcutName: string, allowCollision?: boolean): void;
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
keyCode | string | number | KeyCodes | รหัสแป้นสำหรับแป้นพิมพ์ลัด หากลงทะเบียนรหัสคีย์ที่มีตัวแก้ไข (เช่น Ctrl+C) ให้ใช้ ShortcutRegistry.registry.createSerializedKey; |
shortcutName | สตริง | ชื่อของแป้นพิมพ์ลัดที่จะดำเนินการเมื่อมีการกดรหัสคีย์ที่ระบุ |
allowCollision | บูลีน | (ไม่บังคับ) จริงเพื่อป้องกันข้อผิดพลาดเมื่อเพิ่มทางลัดไปยังแป้นที่มีการแมปกับทางลัดอยู่แล้ว |
การคืนสินค้า:
โมฆะ
ข้อยกเว้น
{Error} หากรหัสแป้นที่ระบุจับคู่กับแป้นพิมพ์ลัดอยู่แล้ว