globalShortcut
当应用程序没有键盘焦点时检测键盘事件。
进程:主进程
globalShortcut
模块可以向操作系统注册/注销一个全局键盘快捷方式,以便您可以为各种快捷方式自定义操作。
注意
此快捷方式是全局的;即使应用程序没有键盘焦点,它也能工作。此模块不能在应用程序模块的 ready
事件发出之前使用。另请注意,也可以使用 Chromium 的 GlobalShortcutsPortal
实现,该实现允许应用程序在 Wayland 会话中运行时绑定全局快捷方式。
const { app, globalShortcut } = require('electron')
// Enable usage of Portal's globalShortcuts. This is essential for cases when
// the app runs in a Wayland session.
app.commandLine.appendSwitch('enable-features', 'GlobalShortcutsPortal')
app.whenReady().then(() => {
// Register a 'CommandOrControl+X' shortcut listener.
const ret = globalShortcut.register('CommandOrControl+X', () => {
console.log('CommandOrControl+X is pressed')
})
if (!ret) {
console.log('registration failed')
}
// Check whether a shortcut is registered.
console.log(globalShortcut.isRegistered('CommandOrControl+X'))
})
app.on('will-quit', () => {
// Unregister a shortcut.
globalShortcut.unregister('CommandOrControl+X')
// Unregister all shortcuts.
globalShortcut.unregisterAll()
})
方法
globalShortcut
模块有以下方法
globalShortcut.register(accelerator, callback)
accelerator
Acceleratorcallback
函数
返回 boolean
- 快捷方式是否成功注册。
注册 accelerator
的全局快捷方式。当用户按下注册的快捷方式时,将调用 callback
。
当加速器已被其他应用程序占用时,此调用将静默失败。这是操作系统的预期行为,因为它们不希望应用程序争夺全局快捷方式。
以下加速器在 macOS 10.14 Mojave 上不会成功注册,除非应用程序已被授权为受信任的辅助功能客户端
- "媒体播放/暂停"
- "媒体下一曲"
- "媒体上一曲"
- "媒体停止"
globalShortcut.registerAll(accelerators, callback)
accelerators
Accelerator[] - 一个 Accelerator 数组。callback
函数
注册 accelerators
中所有 accelerator
项的全局快捷方式。当用户按下任何已注册的快捷方式时,将调用 callback
。
当给定加速器已被其他应用程序占用时,此调用将静默失败。这是操作系统的预期行为,因为它们不希望应用程序争夺全局快捷方式。
以下加速器在 macOS 10.14 Mojave 上不会成功注册,除非应用程序已被授权为受信任的辅助功能客户端
- "媒体播放/暂停"
- "媒体下一曲"
- "媒体上一曲"
- "媒体停止"
globalShortcut.isRegistered(accelerator)
accelerator
Accelerator
返回 boolean
- 此应用程序是否已注册 accelerator
。
当加速器已被其他应用程序占用时,此调用仍将返回 false
。这是操作系统的预期行为,因为它们不希望应用程序争夺全局快捷方式。
globalShortcut.unregister(accelerator)
accelerator
Accelerator
注销 accelerator
的全局快捷方式。
globalShortcut.unregisterAll()
注销所有全局快捷方式。