컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
blockly > ShortcutRegistry > addKeyMapping
ShortcutRegistry.addKeyMapping() 메서드
키 코드와 키보드 단축키 간에 매핑을 추가합니다.
일반적으로 특정 키 코드에 하나의 바로가기만 매핑할 수 있지만 allowCollisions를 true로 설정하면 키보드를 여러 바로가기에 매핑할 수 있습니다. 이 경우 지정된 키 입력으로 onKeyDown이 호출되면 매핑된 단축키가 가장 최근에 매핑된 것부터 가장 오래 전에 매핑된 것까지 역순으로 처리됩니다.
서명:
addKeyMapping(keyCode: string | number | KeyCodes, shortcutName: string, allowCollision?: boolean): void;
매개변수
매개변수 |
유형 |
설명 |
keyCode |
문자열 | 숫자 | KeyCodes |
단축키의 키 코드입니다. 특수키 (예: ctrl+c)를 사용하여 키 코드를 등록하는 경우 ShortcutRegistry.registry.createSerializedKey를 사용하세요. |
shortcutName |
문자열 |
지정된 키 코드를 누를 때 실행할 단축키의 이름입니다. |
allowCollision |
부울 |
(선택사항) 이미 바로가기에 매핑된 키에 바로가기를 추가할 때 오류를 방지하려면 true로 설정합니다. |
반환:
void
예외
지정된 키 코드가 이미 바로가기에 매핑된 경우 {오류}
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[],["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"],null,[]]