为何ShortcutOverride无法阻止QML接收按键事件？

问题原因 #

你遇到的核心问题是对QEvent::ShortcutOverride的作用理解有误：

• ShortcutOverride事件的唯一目的是阻止Qt的默认快捷键处理（比如窗口自带的快捷键逻辑），它并不会拦截后续的KeyPress事件传递。
• 即便你在ShortcutOverride阶段调用event->accept()并返回true，Qt依然会生成正常的KeyPress事件，并将其分发给当前拥有焦点的QML控件（也就是示例中的Rectangle），所以QML的Keys.onPressed依然会被触发。

你的代码仅处理了ShortcutOverride事件，完全没有拦截后续的KeyPress事件，这就是为什么两个输出都会出现。

解决方案 #

要彻底拦截Enter键的事件传递，需要在事件过滤器中同时处理QEvent::ShortcutOverride和QEvent::KeyPress两种事件：

bool Navigation_Control::eventFilter(QObject* watched, QEvent* event)
{
    if (event->type() == QEvent::ShortcutOverride || event->type() == QEvent::KeyPress)
    {
        QKeyEvent* key_event = dynamic_cast<QKeyEvent*>(event);
        if (!key_event)
        {
            return QObject::eventFilter(watched, event);
        }

        int key = key_event->key();
        if (key == Qt::Key_Return)
        {
            std::cout << (event->type() == QEvent::ShortcutOverride ? "Key_Return - ShortcutOverride" : "Key_Return - KeyPress") << std::endl;
            event->accept();
            return true;
        }
    }

    return QObject::eventFilter(watched, event);
}

修改后效果：

1. 处理ShortcutOverride避免Qt默认快捷键触发
2. 处理KeyPress直接拦截事件，阻止其传递到QML的焦点控件，Keys.onPressed就不会再被触发

补充说明 #

Qt键盘事件的大致传递流程：

1. 系统产生键盘事件，Qt包装为ShortcutOverride事件，先通过全局事件过滤器分发
2. 如果ShortcutOverride被接受，Qt不会将该按键视为默认快捷键；否则继续执行默认快捷键逻辑
3. 无论ShortcutOverride的处理结果如何，Qt都会生成KeyPress事件，传递给当前拥有焦点的控件（QML或C++）
4. 控件处理完KeyPress后，还会触发KeyRelease事件，若需要也可按需拦截

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