快捷键

Shortcut 代表一个全局键盘快捷键，也称为系统范围的热键。如果注册成功，即使您的应用程序没有焦点，它也能正常工作。

Shortcut 继承自 EventEmitter。每次用户按下注册的快捷键时，您的应用程序都会收到快捷键对象的 active 事件。

概述

var option = {
  key : "Ctrl+Shift+A",
  active : function() {
    console.log("Global desktop keyboard shortcut: " + this.key + " active."); 
  },
  failed : function(msg) {
    // :(, fail to register the |key| or couldn't parse the |key|.
    console.log(msg);
  }
};

// Create a shortcut with |option|.
var shortcut = new nw.Shortcut(option);

// Register global desktop shortcut, which can work without focus.
nw.App.registerGlobalHotKey(shortcut);

// If register |shortcut| successfully and user struck "Ctrl+Shift+A", |shortcut|
// will get an "active" event.

// You can also add listener to shortcut's active and failed event.
shortcut.on('active', function() {
  console.log("Global desktop keyboard shortcut: " + this.key + " active."); 
});

shortcut.on('failed', function(msg) {
  console.log(msg);
});

// Unregister the global desktop shortcut.
nw.App.unregisterGlobalHotKey(shortcut);

new Shortcut(option)

• option {Object}
  • key {String} 快捷键的键组合，例如 "ctrl+shift+a"。有关详细信息，请参见 shortcut.key 属性。
  • active {Function} 可选 热键触发时的回调。有关详细信息，请参见 shortcut.active 属性。
  • failed {Function} 可选 注册热键失败时的回调。有关详细信息，请参见 shortcut.failed 属性。

创建新的 Shortcut，option 是一个包含 Shortcut 初始设置的对象。

shortcut.key

获取 Shortcut 的 key。它是一个字符串，用于指定快捷键，例如 "Ctrl+Alt+A"。该键由零个或多个修饰符和键盘上的一个键组成。仅支持一个键代码。键代码不区分大小写。

支持的修饰符列表

• Ctrl
• Alt
• Shift
• Command：Command 修饰符在 Mac 上映射到 Apple 键 (⌘)，在 Windows 和 Linux 上映射到 Windows 键。

支持的按键列表

• 字母：A-Z
• 数字：0-9
• 功能键：F1-F24
• 逗号
• 句号
• 制表符
• Home / End / PageUp / PageDown / Insert / Delete
• Up / Down / Left / Right
• MediaNextTrack / MediaPlayPause / MediaPrevTrack / MediaStop
• 逗号 或 ,
• 句号 或 .
• 制表符 或 \t
• 反引号 或 `
• 回车 或 \n
• 减号 或 -
• 等号 或 =
• 反斜杠 或 \
• 分号 或 ;
• 单引号 或 '
• 左方括号 或 [
• 右方括号 或 ]
• Escape
• DOM Level 3 W3C KeyboardEvent 代码值

shortcut.active

获取或设置 Shortcut 的 active 回调。当用户按下快捷键时，将调用它。

shortcut.failed

*获取或设置 Shortcut 的 failed 回调。当应用程序传递无效的键或注册键失败时，将调用它。

事件：active

与 shortcut.active 相同

事件：failed

与 shortcut.failed 相同