electron/docs/api/global-shortcut-ko.md
2015-07-15 08:30:02 +09:00

1.8 KiB

global-shortcut

global-shortcut 모듈은 사용자가 다양한 단축키 작업을 정의 할 수 있도록 운영체제의 전역 키보드 단축키를 설정 등록/해제 하는 방법을 제공합니다. 참고로 설정된 단축키는 어플리케이션이 백그라운드로 작동(창이 포커스 되지 않음) 할 때도 여전히 계속 작동합니다. 이 모듈은 app 모듈의 ready 이밴트 이전에 사용할 수 없습니다.

var app = require('app');
var globalShortcut = require('global-shortcut');

app.on('ready', function() {
  // 'ctrl+x' 단축키를 리스너에 등록합니다.
  var ret = globalShortcut.register('ctrl+x', function() { console.log('ctrl+x is pressed'); })

  if (!ret) {
    console.log('registration failed');
  }

  // 단축키가 등록되었는지 확인합니다.
  console.log(globalShortcut.isRegistered('ctrl+x'));
});

app.on('will-quit', function() {
  // 단축키의 등록을 해제합니다.
  globalShortcut.unregister('ctrl+x');

  // 모든 단축키의 등록을 해제합니다.
  globalShortcut.unregisterAll();
});

globalShortcut.register(accelerator, callback)

accelerator로 표현된 전역 단축키를 등록합니다. 유저로부터 등록된 단축키가 눌렸을 경우 callback 함수가 호출됩니다.

globalShortcut.isRegistered(accelerator)

지정된 accelerator 단축키가 등록되었는지 여부를 확인합니다. 반환값은 boolean(true, false) 입니다.

globalShortcut.unregister(accelerator)

키코드에 해당하는 전역 단축키를 등록 해제합니다.

globalShortcut.unregisterAll()

모든 전역 단축키 등록을 해제합니다.