globalShortcut
Détecte les événements de clavier lorsque l'application n'a pas le focus du clavier.
Process: Main
Le module globalShortcut
peut inscrire/désinscrire un raccourci clavier global avec le système d'exploitation afin que vous puissiez personnaliser les opérations pour les différents raccourcis.
Remarque : Le raccourci est global; il fonctionnera même si l'application n'a pas le focus du clavier. Ce module ne peut pas être utilisé avant que l'événement ready
du module ne soit émis.
const { app, globalShortcut } = require('electron')
app.whenReady().then(() => {
// Enregistre un écouteur pour le raccourci 'CommandOrControl+X.
const ret = globalShortcut.register('CommandOrControl+X', () => {
console.log('CommandOrControl+X is pressed')
})
if (!ret) {
console.log('enregistrement échoué')
}
// Check si le raccourci est enregistré.
console.log(globalShortcut.isRegistered('CommandOrControl+X'))
})
app.on('will-quit', () => {
// Retire le raccourci.
globalShortcut.unregister('CommandOrControl+X')
// Supprime tous les raccourcis.
globalShortcut.unregisterAll()
})
Méthodes
Le module globalShortcut
dispose des méthodes suivantes :
globalShortcut.register(accelerator, callback)
accelerator
Acceleratorcallback
Function
Retourne boolean
- Si le raccourci a été enregistré avec succès.
Enregistre un raccourci global correspondant à accelerator
. La callback
est appelée lorsque le raccourci enregistré est saisi par l'utilisateur.
Lorsque l'accélérateur est déjà utilisé par d'autres applications, cet appel échouera silencieusement. Ce comportement est prévu par les systèmes d'exploitation, car ils ne veulent pas que les applications se battent pour des raccourcis globaux.
Les accélérateurs suivants ne seront pas enregistrés correctement sur macOS 10.14 Mojave à moins que l'application ait été autorisée en tant qu'application client approuvée :
- "Media Play/Pause"
- "Media Piste Suivante"
- "Media Piste Précédente"
- "Media Stop"
globalShortcut.registerAll(accélérateurs, callback)
accelerators
Accelerator[] - an array of Accelerators.callback
Function
Enregistre un raccourci global pour chaque élément accelerator
de accelerators
. La callback
est appelée lorsque l'un des raccourcis enregistrés est saisi par l'utilisateur.
Lorsqu'un accélérateur donné est déjà pris par d'autres applications, cet appel échouera silencieusement. Ce comportement est prévu par les systèmes d'exploitation, car ils ne veulent pas que les applications se battent pour des raccourcis globaux.
Les accélérateurs suivants ne seront pas enregistrés correctement sur macOS 10.14 Mojave à moins que l'application ait été autorisée en tant qu'application client approuvée :
- "Media Play/Pause"
- "Media Piste Suivante"
- "Media Piste Précédente"
- "Media Stop"
globalShortcut.isRegistered(accelerator)
accelerator
Accelerator
Retourne un boolean
- Si l'application à enregistrer l'accelerator
.
Lorsque l'accelerator est déjà utilisé par d'autres applications, cet appel retournera toujours false
. Ce comportement est prévu par les systèmes d'exploitation, car ils ne veulent pas que les applications se battent pour des raccourcis globaux.
globalShortcut.unregister(accelerator)
accelerator
Accelerator
Supprime le raccourci global de l'accelerator
.
globalShortcut.unregisterAll()
Supprime tous les raccourcis globaux.