如何在Qt中捕获PrintScreen按键？现有代码无法检测该按键

我之前也遇到过这个问题，PrintScreen按键在Qt里的捕获确实有点特殊——很多系统会优先拦截这个按键来触发自带的截图功能，导致普通的按键事件处理失效。下面给你几种可行的解决方案：

如果你的应用窗口处于激活状态（有焦点），重写窗口类的keyPressEvent方法就能捕获到PrintScreen按键：

#include <QKeyEvent>
#include <QMainWindow>

class MainWindow : public QMainWindow
{
    Q_OBJECT
protected:
    void keyPressEvent(QKeyEvent *event) override
    {
        // 检测PrintScreen按键，Qt对应的键值是Qt::Key_Print
        if (event->key() == Qt::Key_Print) {
            qDebug() << "PrintScreen按键被触发！";
            // 这里添加你的截图或处理逻辑
            event->accept(); // 阻止事件继续传递给系统
        } else {
            // 其他按键交给父类处理
            QMainWindow::keyPressEvent(event);
        }
    }
};

这种方法的局限性是：只有当你的应用窗口处于前台且有焦点时才能生效，如果窗口被最小化或失去焦点，就捕获不到了。

如果需要在应用后台也能捕获PrintScreen，就需要给QApplication安装全局事件过滤器，它能在事件到达任何窗口之前就拦截到：

首先定义一个事件过滤器类：

#include <QObject>
#include <QEvent>
#include <QKeyEvent>
#include <QDebug>

class PrintScreenFilter : public QObject
{
    Q_OBJECT
protected:
    bool eventFilter(QObject *obj, QEvent *event) override
    {
        if (event->type() == QEvent::KeyPress) {
            QKeyEvent *keyEvent = static_cast<QKeyEvent*>(event);
            if (keyEvent->key() == Qt::Key_Print) {
                qDebug() << "全局捕获到PrintScreen按键！";
                // 执行你的处理逻辑
                return true; // 返回true阻止事件继续传递给系统或其他窗口
            }
        }
        // 其他事件交给原处理逻辑
        return QObject::eventFilter(obj, event);
    }
};

然后在main函数中安装这个过滤器：

#include <QApplication>
#include "MainWindow.h"

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    PrintScreenFilter filter;
    a.installEventFilter(&filter); // 安装全局过滤器

    MainWindow w;
    w.show();

    return a.exec();
}

• 跨平台差异：macOS没有单独的PrintScreen按键，需要处理Command+Shift+3/Command+Shift+4这类组合键，可以通过keyEvent->modifiers()判断修饰键，配合key()来捕获；
• 系统拦截优先级：部分系统会强制优先处理PrintScreen触发自带截图，这时候即使使用全局过滤器也可能无法完全拦截，可以考虑配合系统提供的截图API来实现自定义逻辑；
• Wayland环境：在Linux的Wayland桌面下，全局事件捕获需要额外权限，建议直接调用Wayland的截图接口来实现功能。

内容的提问来源于stack exchange，提问作者GUI-Novice