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

转载 2012年03月29日 16:20:43

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

即可

相关文章推荐

qt全局热键demo

  • 2017年07月19日 10:22
  • 14KB
  • 下载

Qt全局热键(windows篇)

Qt全局热键、winEventFilter、RegisterHotKey

Qt全局热键(Windows篇)

转载:http://www.cuteqt.com/blog/?p=2088 Qt对于系统底层,一直没有很好的支持,例如串口并口通信,还有我们经常都会用到的全局热键,等等。既然Qt可能出于某种...
  • mycoolx
  • mycoolx
  • 2011年12月18日 15:56
  • 759

Qt全局热键(windows篇)(转自:http://www.cuteqt.com/blog/?p=2088)

本站所有文章由本站和原作者保留一切权力,仅在保留本版权信息、原文链接、原文作者的情况下允许转载,转载请勿删改原文内容, 并不得用于商业用途。 谢谢合作。 原文链接:Qt全局热键(window...
  • lslxdx
  • lslxdx
  • 2012年03月28日 21:29
  • 1253

Qt 全局热键的详细解析

Qt 全局热键 QxtGlobalShortcut 分析与使用举例,与你分享,如果你需要全局热键,那么本文将会为你解决。 首先: 使用 RegisterHotKey和 UnregisterHotKe...

Qt全局热键

Qt对于系统底层,一直没有很好的支持,例如串口并口通信,还有我们经常都会用到的全局热键,等等。既然Qt可能出于某种原因,不对这些进行支持,我们就只能自己写代码,调用系统相关的API了。 注意,这...
  • koilin
  • koilin
  • 2012年07月17日 10:49
  • 4319

章鱼哥出品—VB.NET 自定义快捷键使用详解之全局热键

如何设置VB.NET 窗体的全局热键(快捷键),

Windows全局热键查看程序

  • 2010年10月11日 20:15
  • 1.45MB
  • 下载

C#实现全局快捷键(系统热键)响应(转)

在应用中,我们可能会需要实现像Ctrl+C复制、Ctrl+V粘贴这样的快捷键,本文简单介绍了它的实现,并给出了一个实现类。 (1)建立一个类文件,命名为HotKey.cs,代码如下:...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Qt 全局热键 QxtGlobalShortcut 分析与使用举例
举报原因:
原因补充:

(最多只允许输入30个字)