mirror of
https://github.com/electron/electron.git
synced 2026-01-08 23:18:06 -05:00
Make it clear that the `global-shortcut` module should not be used until the ready event of app module gets emitted.
1.4 KiB
1.4 KiB
global-shortcut
The global-shortcut module can register/unregister a global keyboard shortcut
in operating system, so that you can customize the operations for various shortcuts.
Note that the shortcut is global, even if the app does not get focused, it will still work.
You should not use this module until the ready event of app module gets emitted.
var globalShortcut = require('global-shortcut');
// Register a 'ctrl+x' shortcut listener.
var ret = globalShortcut.register('ctrl+x', function() { console.log('ctrl+x is pressed'); })
if (!ret) {
console.log('registration failed');
}
// Check whether a shortcut is registered.
console.log(globalShortcut.isRegistered('ctrl+x'));
// Unregister a shortcut.
globalShortcut.unregister('ctrl+x');
// Unregister all shortcuts.
globalShortcut.unregisterAll();
globalShortcut.register(accelerator, callback)
acceleratorAcceleratorcallbackFunction
Registers a global shortcut of accelerator, the callback would be called when
the registered shortcut is pressed by user.
globalShortcut.isRegistered(accelerator)
acceleratorAccelerator
Returns true or false depending on if the shortcut accelerator is registered.
globalShortcut.unregister(accelerator)
acceleratorAccelerator
Unregisters the global shortcut of keycode.
globalShortcut.unregisterAll()
Unregisters all the global shortcuts.