Qt Quick程序如何独占控制键盘鼠标？兼容Qt5与Qt6

该需求完全可行。Qt Quick本身虽未提供grabKeyboard()/grabMouse()这类直接接口，但可通过事件过滤、结合Qt底层窗口机制实现键盘/鼠标事件的独占拦截，将目标快捷键转发至远程服务器，阻止本地程序响应。

Qt5实现方案 #

1. 窗口级事件过滤器 #

通过给QQuickView或QQuickWidget安装事件过滤器，拦截所有键盘事件并按需处理：

#include <QObject>
#include <QEvent>
#include <QKeyEvent>
#include <QQuickView>

class KeyboardGrabFilter : public QObject
{
    Q_OBJECT
protected:
    bool eventFilter(QObject *obj, QEvent *event) override
    {
        if (event->type() == QEvent::KeyPress || event->type() == QEvent::KeyRelease) {
            QKeyEvent *keyEvent = static_cast<QKeyEvent*>(event);
            
            // 拦截并转发Alt+F4到远程服务器
            if (keyEvent->modifiers() == Qt::AltModifier && keyEvent->key() == Qt::Key_F4) {
                // 此处添加向远程服务器发送按键事件的逻辑
                return true; // 返回true阻止事件传递给本地程序
            }
            
            // 可扩展处理其他所有键盘事件，统一转发至远程端
            // ...
        }
        return QObject::eventFilter(obj, event);
    }
};

// 主程序中安装过滤器
int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);
    QQuickView view;
    
    KeyboardGrabFilter filter;
    view.installEventFilter(&filter);
    
    view.setSource(QUrl(QStringLiteral("qrc:/main.qml")));
    view.show();
    return app.exec();
}

2. 鼠标独占实现 #

类似键盘逻辑，在事件过滤器中拦截QEvent::MouseButtonPress/MouseButtonRelease/MouseMove等事件，转发至远程服务器后返回true，阻止本地程序处理鼠标输入。

Qt6实现方案 #

Qt6优化了事件处理机制，可选择全局事件过滤器或QML Item级事件拦截：

1. 全局事件过滤器 #

针对整个应用捕获键盘事件，确保远程窗口激活时独占键盘：

#include <QObject>
#include <QEvent>
#include <QKeyEvent>
#include <QQuickWindow>
#include <QGuiApplication>

class GlobalKeyboardFilter : public QObject
{
    Q_OBJECT
protected:
    bool eventFilter(QObject *obj, QEvent *event) override
    {
        if (event->type() == QEvent::KeyPress || event->type() == QEvent::KeyRelease) {
            QKeyEvent *keyEvent = static_cast<QKeyEvent*>(event);
            QQuickWindow *remoteWindow = qobject_cast<QQuickWindow*>(obj);
            
            // 仅在远程桌面窗口激活时拦截事件
            if (remoteWindow && remoteWindow->isActive()) {
                if (keyEvent->modifiers() == Qt::AltModifier && keyEvent->key() == Qt::Key_F4) {
                    // 转发按键事件至远程服务器
                    return true;
                }
                // 处理其他键盘事件
                // ...
            }
        }
        return QObject::eventFilter(obj, event);
    }
};

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);
    GlobalKeyboardFilter filter;
    app.installEventFilter(&filter); // 全局安装过滤器
    
    QQuickView view;
    view.setSource(QUrl(QStringLiteral("qrc:/main.qml")));
    view.show();
    return app.exec();
}

2. QML Item级事件拦截 #

让全屏QML Item获取焦点，直接在QML中处理键盘事件：

import QtQuick 6.2

Rectangle {
    anchors.fill: parent
    focus: true // 必须获取焦点才能接收键盘事件

    Keys.onPressed: {
        if ((event.modifiers & Qt.AltModifier) && (event.key === Qt.Key_F4)) {
            // 调用C++后端的事件转发方法
            remoteDesktopBackend.forwardKeyEvent(event)
            event.accepted = true // 阻止事件向上传递
        }
    }

    Keys.onReleased: {
        // 同理处理按键释放事件
        event.accepted = true
    }
}

关键注意事项 #

• 必须设置退出独占的快捷键（如Ctrl+Alt+Esc），避免用户无法操作本地系统。
• 系统级快捷键（如Win+Tab、macOS的Cmd+Tab）无法通过Qt事件过滤拦截，需调用平台原生API处理（如Windows的RegisterHotKey、Linux的X11事件钩子）。
• 鼠标独占可复用上述事件过滤逻辑，拦截鼠标事件后转发至远程服务器。

内容的提问来源于stack exchange，提问作者ArrayBolt3