Qt/PyQt中使用系统全局的快捷键

最新推荐文章于 2025-03-29 20:44:33 发布

原创最新推荐文章于 2025-03-29 20:44:33 发布 · 5.4k 阅读

3 ·

CC 4.0 BY-SA版权

pyqt 专栏收录该内容

49 篇文章

订阅专栏

本文介绍如何在Qt和PyQt中实现系统全局快捷键的功能，包括使用RegisterHotKey注册快捷键，以及重载QApplication的winEventFilter函数来响应快捷键事件。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Qt/PyQt中使用系统全局的快捷键

除了全局快捷键部分外，其他的都比较简单，都是我实现“onekeycodehighlighter"中碰到的一些小问题，这里顺面整理一下。事实上，稍微懂一点的人，去看看one key code highlighter的源代码都能明白了。这里相当于将其详细的剖析一下。。。。。。。另外，实现上用Python+PyQt，事实上，主要的部分是对Qt的一些类的使用，所以其实看懂了C++的Qt中使用上是一样的。啥？你看不懂Python？好的，这就是我为什么靠C++吃饭，却学习JAVA,JavaScript,Lua,Python,Bash的一个原因，不然你看不懂别人在写啥-_-!（当然，我基本上也就学到能看懂）
对于pyQt完全不懂的，这里也不用看了，《pyqt的学习(1) 入门》，《pyqt(2) 对话框...》

概述

使用系统全局的快捷键总是键很酷的事情，在你的程序已经失去焦点的时候，还能响应用户的按键，完成任务，多酷啊。特别的，我的one key code highlighter只有一个SystemTrayIcon（托盘图标）和一些菜单，不使用系统全局的快捷键而用菜单去实现命令的话，我还不如用快捷方式去使用chc2c呢（就如我以前做的那样）。所以，对于这个我自己需要而实现的软件，怎么说，也需要有这个功能，无奈的是，偏偏Qt中其实原生不支持此功能，那么，只好放弃移植性去使用win32 API了。

Qt中的实现

主要的API为：（来自MSDN)

BOOL RegisterHotKey(          HWND hWnd,
    int id,
    UINT fsModifiers,
    UINT vk
);

在Qt中实现并不算什么大问题，《Qt中使用全局热键》中有一些说明，此文说明了一件事情，技术文章的价值不以篇幅来衡量，而是以技术含量衡量，此文没有太多的文字，但是详细解释了所有过程。
主要步骤为用RegisterHotKey向系统注册全局的快捷键，然后重载QApplication的winEventFilter函数，并响应msg为WM_HOTKEY时的消息，整个过程类似于在Windows下的OnMessage进行消息响应，只是这次是在Qt中。原文给出的示例代码如下：（原文排版有点乱，但是不损其技术价值）

bool winEventFilter(MSG *msg, long *result)
{
    if(WM_HOTKEY==msg->message)
    {
        qDebug()<<"winmsg return true";
        emit hotKey(int(msg->wParam),LOWORD(msg->lParam),HIWORD(msg->lParam));
        return TRUE;
    }
    return FALSE;
}
这种实现很简单，我就不多说了，Qt嘛，毕竟还是C++，只不过这里放弃移植性调用Win32 API，并且响应消息而已，没有什么太多新的东西。

PyQt中的实现

相对于Qt中的实现来说，对于Qt中没有的东西，很显然PyQt中也很难有了，那么，我们还是只能通过调用Win32 API了，而在Python中调用Win32 API就没有那么太简单了。。。。。。。
介绍的是用ctypes来调用，当然，因为感觉此部分会与本主题太偏，所以额外写了一篇文章讲述。《Python与C之间的相互调用（Python C API及Python ctypes库）》，看了前文就会知道，其实用Python C API包装以下RegisterHotKey也可以实现一样的效果，知识用ctypes更简单一些。
这里就直接讲RegisterHotKey的调用了。以下是一些代码片段。。。。。

from ctypes import c_bool, c_int, WINFUNCTYPE, windll
from ctypes.wintypes import UINT

prototype = WINFUNCTYPE(c_bool, c_int, c_int, UINT, UINT)
paramflags = (1, 'hWnd', 0), (1,'id', 0), (1,'fsModifiers', 0), (1,'vk', 0)
self.RegisterHotKey = prototype(('RegisterHotKey', windll.user32), paramflags)

r = self.RegisterHotKey(c_int(self.mainWindow.winId()), HOT_KEY_ID, config.modifier, ord( config.hotkey.upper() ))
if not r:
      QtGui.QMessageBox.critical(None, 'Hot key','Can't Register Hotkey Win + Z')
      sys.exit(1)
这里用了比直接调用RegisterHotKey更复杂的方法来使用ctypes，（在《Python与C之间的相互调用（Python C API及Python ctypes库）》中描述了最简单的办法），好处是实现了“命名参数”及参数默认值，这里虽然实际没有使用-_-!另外，利用config中的配置的大写字母的ord，来表示Windows中的虚拟键值真是很方便，为什么这样能省去那一大堆的VK_*定义？因为WinUser.h中就是这样定义这些VK_*的。。。。。。。
还有，mainWindow实际是一个QMainWindow的对象，其winId函数可以获取到Windows窗口的句柄，这里将其转化为c_int而不是HWND，因为在Python中不允许从int到HWND的转换（这有点扭曲），知道原因的请告诉我。完成了这些后，QApplication的winEventFilter函数的重载还是少不了的。

以下是我的一段实现代码：

    # these code don't have compatibility with other OS
    def winEventFilter(self, msg):
        debug_out("Message:" + str(hex(msg.message)) )
        if msg.message == WM_HOTKEY:
            if isClipboardEmpty():
                self.mainWindow.trayIcon.showMessage("failed","Clipboard is Empty.")
                return True, 0
            debug_out("Got the Hotkey!")
            debug_out(config.filename)

            import imp
            imp.reload(config)
            chc2c(self.mainWindow.syn, config.color, config.isLineNumber, config.filename)
            self.mainWindow.trayIcon.showMessage("success","transformed the data in clipboard to html.")
            return True, 0

        return False, 0

基本思路与C++中并无差异，查找到WM_HOTKEY，然后响应之。我这里利用了reload来达到每次都动态查询配置的效果^^chc2c就是我的主要函数。
以上就是PyQt中实现全局快捷键的全部过程了。

另外，我本来以为假如愿意使用PyWin32的话，直接可以调用其中的RegisterHotKey，后来竟然在里面没有找到，奇了怪了。