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 布林值 (選用) 如為 true，系統會避免在已對應至捷徑的鍵上新增捷徑時發生錯誤。

退貨：

void

例外狀況

如果指定的按鍵代碼已對應至捷徑，則會顯示 {Error}。