Qt 全局热键 QxtGlobalShortcut 分析与使用举例

现在的位置: 首页 > 自动控制 > 工业·编程 > 正文

RSS

上篇下篇

Qt 全局热键 QxtGlobalShortcut 分析与使用举例

2014-05-09 23:07 ⁄ 工业·编程 ⁄ 共 3332字 ⁄ 字号小中大 ⁄ 暂无评论

不少人有给程序添加全局热键的需求。网上随便一搜，就能找到不少介绍windows下如何实现的方式：

首先：使用 RegisterHotKey和 UnregisterHotKey 注册和反注册热键
其次：在事件全局过滤器 winEventFilter 中相应热键

但是涉及其他平台的，中文资料中提到的似乎不多。

libqxt

其实Qt第三方的库 libqxt 中已经给出了一个比较好的跨平台的解决方案，这就是 QxtGlobalShortcut。

所以，只要你使用这个第三方库就可以了。

可是，你会不会想，我仅仅为了使用这个类，而引入这个 libqxt 第三方库是不是有点大题小做？我能不能将其剥离出来单独使用？

QxtGlobalShortcut

恩，用google搜索一下，就可以知道，网上很多人都做过这个工作了。你会发现很多人将剥离出的 QxtGlobalShortcut 作为项目的 3rdparty 部分。

那么我们接下来就看看这个 QxtGlobalShortcut :

用法

已经简单到不能再简单了，是不？

QxtGlobalShortcut* shortcut = new QxtGlobalShortcut(QKeySequence("Ctrl+Shift+F12"), w);
connect(shortcut, SIGNAL(activated()), w, SLOT(myslot()));

注意：如果你对其内部实现不感兴趣，只关心如何使用，那么这个小例子可能就是你需要的全部了：http://code.google.com/p/h-qt-exercise/downloads/detail?name=shortcut.zip&can=2&q=

源码文件

	gxtglobal.h	libqxt 一个全局文件
*	qxtglobalshortcut.h	我们最关心的接口文件
	qxtglobalshortcut_.h	私有头文件
	gxtglobalshortcut.cpp	类的实现(平台无关部分)
	gxtglobalshortcut_win.cpp	类的实现(win)
	gxtglobalshortcut_x11.cpp	类的实现(x11)
	gxtglobalshortcut_mac.cpp	类的实现(mac)

热键的注册过程

我们通过构造函数，或者setShortcut 成员设置一个热键时：

首先将这个 QKeySequence 分解成两部分 Qt::Key 和 Qt::KeyboardModifiers

（即：下面的 key 和 mods）

然后，key 和 mods 分别转换成平台相关(native)的码值，并调用平台相关的函数进行注册

最后，将key与mods的native码值构成的QPair作为QHash的键，将该shortcut的指针作为值保存起来。

bool QxtGlobalShortcutPrivate::setShortcut(const QKeySequence& shortcut)

{

...

key = ...

mods = ...

const quint32 nativeKey = nativeKeycode(key);

const quint32 nativeMods = nativeModifiers(mods);

const bool res = registerShortcut(nativeKey, nativeMods);

shortcuts.insert(qMakePair(nativeKey, nativeMods), &qxt_p());

...

反注册的过程与此类似。

热键激活

首先给 QAbstractEventDispatcher 安装事件过滤器

QAbstractEventDispatcher::instance()->setEventFilter(eventFilter);

注意，这儿不是给 QApplication 安装的。Manual中是这样告诉我们的

bool QCoreApplication::winEventFilter ( MSG * msg, long * result ) [virtual]

To handle system wide messages, such as messages from a registered hot key, you need to install an event filter on the event dispatcher, which is returned from QAbstractEventDispatcher::instance().

然后我们在过滤器中分别进行处理，比如windows下

bool QxtGlobalShortcutPrivate::eventFilter(void* message)

{

MSG* msg = static_cast<MSG*>(message);

if (msg->message == WM_HOTKEY){

const quint32 keycode = HIWORD(msg->lParam);

const quint32 modifiers = LOWORD(msg->lParam);

activateShortcut(keycode, modifiers);

}

return false;

}

或 x11 下：

bool QxtGlobalShortcutPrivate::eventFilter(void* message)

{

XEvent* event = static_cast<XEvent*>(message);