如何在QMenu中正确实现带按钮的QWidgetAction并修复聚焦导航问题

问题根源 #

QWidgetAction嵌入的自定义控件会接管焦点处理逻辑，导致菜单默认的上下箭头导航被打断——当焦点落在按钮上时，上下键事件会被按钮自身消费，无法传递给菜单来切换到相邻的QAction。

解决方案 #

给承载按钮的容器控件安装事件过滤器，拦截上下箭头按键事件，手动触发菜单的焦点切换逻辑。

步骤1：添加事件过滤器声明 #

在你的WTrackMenu类声明中添加事件过滤器的重写声明：

class WTrackMenu : public QMenu {
    Q_OBJECT
    // ... 已有成员
protected:
    bool eventFilter(QObject* watched, QEvent* event) override;
};

步骤2：安装事件过滤器 #

在初始化QWidgetAction的代码中，给按钮容器控件安装事件过滤器：

// ... 你的原有代码
pWidgetAutoDJButtons->setFocusProxy(pBtn1);
// 添加这行
pWidgetAutoDJButtons->installEventFilter(this);

m_pAutoDJBtnAction->setDefaultWidget(pWidgetAutoDJButtons);
addAction(m_pAutoDJBtnAction);

步骤3：实现事件过滤器逻辑 #

bool WTrackMenu::eventFilter(QObject* watched, QEvent* event) {
    // 只处理目标容器控件的按键事件
    if (watched->objectName() == "WTrackMenuAutoDJButtons" && 
        event->type() == QEvent::KeyPress) {
        QKeyEvent* keyEvent = static_cast<QKeyEvent*>(event);
        if (keyEvent->key() == Qt::Key_Up) {
            // 切换到上一个Action
            QAction* prevAction = previousAction(m_pAutoDJBtnAction);
            if (prevAction) {
                prevAction->setFocus();
                return true; // 拦截事件，不再传递
            }
        } else if (keyEvent->key() == Qt::Key_Down) {
            // 切换到下一个Action
            QAction* nextAction = nextAction(m_pAutoDJBtnAction);
            if (nextAction) {
                nextAction->setFocus();
                return true; // 拦截事件，不再传递
            }
        }
    }
    // 其他事件交给父类处理
    return QMenu::eventFilter(watched, event);
}

优化补充 #

为了避免按钮自身消费上下键事件，可以将按钮的焦点策略改为仅响应Tab键，确保上下键事件能传递到容器控件：

pBtn1->setFocusPolicy(Qt::TabFocus);
pBtn2->setFocusPolicy(Qt::TabFocus);
pBtn3->setFocusPolicy(Qt::TabFocus);

兼容性说明 #

该方案完全兼容Qt 5.12版本，QMenu::previousAction()和QMenu::nextAction()在该版本已稳定提供，事件过滤器机制也无版本兼容问题。

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