Qt 全局热键 QxtGlobalShortcut 学习

不少人有给程序添加全局热键的需求。网上随便一搜,就能找到不少介绍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())); 源码文件

   

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); if (event->type == KeyPress){ XKeyEvent* key = (XKeyEvent*) event; activateShortcut(key->keycode, key->state & (ShiftMask | ControlMask | Mod1Mask | Mod4Mask)); } return false; }

其中activateShortcut是平台无关的:

void QxtGlobalShortcutPrivate::activateShortcut(quint32 nativeKey, quint32 nativeMods) { QxtGlobalShortcut* shortcut = shortcuts.value(qMakePair(nativeKey, nativeMods)); if (shortcut && shortcut->isEnabled()) emit shortcut->activated(); }

记得前面注册热键是保存东西到一个QHash么?它是在这儿起作用的,当一个热键到来时,我们从该QHash查找有没有相应的QxtGlobalShortcut存在,存在且启用的话,则发射信号。

如何使用

为了便于使用,我们可以在这个文件的同级目录中添加一个 qxtglobalshortcut.pri 的文件:

INCLUDEPATH += $$PWD DEPENDPATH += $$PWD HEADERS += $$PWD/qxtglobal.h \ $$PWD/qxtglobalshortcut.h \ $$PWD/qxtglobalshortcut_p.h SOURCES += $$PWD/qxtglobalshortcut.cpp win32{ SOURCES += $$PWD/qxtglobalshortcut_win.cpp LIBS += -luser32 } unix:SOURCES += $$PWD/qxtglobalshortcut_x11.cpp mac:SOURCES += $$PWD/qxtglobalshortcut_mac.cpp

这样一来,当我们使用时,只需要在我们的pro文件内多加一行:

include(yourpath/qxtglobalshortcut.pri)

即可


点击这里下载一个具体的小例子

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/wwxfgs.html