如何实现点击应用其他区域时自动隐藏Qt QWidget侧边栏？

可通过给QApplication全局安装事件过滤器的方案实现，完全覆盖需求，同时规避你提到的所有方案的缺陷。

实现逻辑 #

• 仅在侧边栏显示时向qApp注册全局事件过滤器，侧边栏隐藏时自动注销，无冗余性能损耗
• 仅监听两类用户主动交互事件：鼠标点击事件、可触发控件操作的按键事件（Enter/Return/Space），Tab导航等非交互操作不会触发侧边栏隐藏
• 收到交互事件后，递归判断事件触发控件的父级链：如果控件不属于侧边栏、也不是触发侧边栏显示的按钮，就自动隐藏侧边栏
• 不拦截原始事件，事件会继续传递给目标控件，用户点击其他控件的操作会直接触发，无需二次点击

参考代码实现 #

#include <QWidget>
#include <QApplication>
#include <QShowEvent>
#include <QHideEvent>
#include <QEvent>
#include <QKeyEvent>

class SideDrawer : public QWidget
{
    Q_OBJECT
public:
    explicit SideDrawer(QWidget *parent = nullptr, QWidget *triggerBtn = nullptr)
        : QWidget(parent), m_triggerBtn(triggerBtn) {}

protected:
    void showEvent(QShowEvent *event) override {
        QWidget::showEvent(event);
        // 显示时注册全局事件过滤器
        qApp->installEventFilter(this);
    }

    void hideEvent(QHideEvent *event) override {
        QWidget::hideEvent(event);
        // 隐藏时注销全局事件过滤器
        qApp->removeEventFilter(this);
    }

    bool eventFilter(QObject *watched, QEvent *event) override {
        // 筛选有效交互事件
        bool isInteractEvent = false;
        if (event->type() == QEvent::MouseButtonPress || event->type() == QEvent::MouseButtonRelease) {
            isInteractEvent = true;
        } else if (event->type() == QEvent::KeyPress) {
            QKeyEvent *keyEvent = static_cast<QKeyEvent*>(event);
            if (keyEvent->key() == Qt::Key_Enter || keyEvent->key() == Qt::Key_Return || keyEvent->key() == Qt::Key_Space) {
                isInteractEvent = true;
            }
        }
        if (!isInteractEvent) {
            return QWidget::eventFilter(watched, event);
        }

        // 判断事件触发控件是否属于侧边栏或触发按钮
        QWidget *eventWidget = qobject_cast<QWidget*>(watched);
        if (!eventWidget) return QWidget::eventFilter(watched, event);
        
        bool isInRelatedArea = false;
        QWidget *cur = eventWidget;
        while (cur) {
            if (cur == this || cur == m_triggerBtn) {
                isInRelatedArea = true;
                break;
            }
            cur = cur->parentWidget();
        }

        if (!isInRelatedArea) {
            hide();
            // 不拦截事件，继续传递给目标控件，不影响用户正常操作
        }
        return QWidget::eventFilter(watched, event);
    }

private:
    QWidget *m_triggerBtn = nullptr;
};

可选适配调整 #

• 如果侧边栏内部有弹出的二级菜单、下拉框等独立子窗口，可在父级链判断逻辑中额外添加这类控件的归属判定，避免交互时误关侧边栏
• 可根据业务需求调整监听的交互事件类型，比如添加滚轮事件、触摸屏点击事件的适配

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