Qt中QScrollArea内QTabWidget滚轮事件冲突问题求助

方法一：自定义QTabBar重写滚轮事件 #

原生QTabBar处理滚轮切换标签后，没有明确阻止事件向上传递，导致上层QScrollArea也会响应滚动。我们可以自定义TabBar类，重写wheelEvent方法，完成标签切换后标记事件已处理，阻止其继续传递。

代码示例：

#include <QTabBar>

class CustomTabBar : public QTabBar
{
    Q_OBJECT
public:
    explicit CustomTabBar(QWidget *parent = nullptr) : QTabBar(parent) {}

protected:
    void wheelEvent(QWheelEvent *event) override
    {
        // 处理滚轮切换标签逻辑
        if (event->angleDelta().y() > 0) {
            // 向上滚轮，切换到前一个标签
            setCurrentIndex((currentIndex() - 1 + count()) % count());
        } else {
            // 向下滚轮，切换到后一个标签
            setCurrentIndex((currentIndex() + 1) % count());
        }
        // 标记事件已处理，阻止传递给父控件
        event->accept();
    }
};

替换QTabWidget默认的tabBar：

QTabWidget *tabWidget = new QTabWidget(this);
tabWidget->setTabBar(new CustomTabBar(tabWidget));

方法二：给QTabBar安装事件过滤器 #

如果不想自定义控件，也可以给现有QTabWidget的tabBar安装事件过滤器，在过滤器中拦截并处理滚轮事件：

代码示例（在父窗口类中实现）：

// 初始化时给tabBar安装过滤器
QTabWidget *tabWidget = new QTabWidget(this);
tabWidget->tabBar()->installEventFilter(this);

// 重写事件过滤器方法
bool YourParentWidget::eventFilter(QObject *watched, QEvent *event)
{
    if (watched == tabWidget->tabBar() && event->type() == QEvent::Wheel) {
        QWheelEvent *wheelEvent = static_cast<QWheelEvent*>(event);
        // 执行标签切换逻辑
        int currentIdx = tabWidget->currentIndex();
        int tabCount = tabWidget->count();
        if (wheelEvent->angleDelta().y() > 0) {
            tabWidget->setCurrentIndex((currentIdx - 1 + tabCount) % tabCount);
        } else {
            tabWidget->setCurrentIndex((currentIdx + 1) % tabCount);
        }
        // 返回true表示拦截事件，不继续传递
        return true;
    }
    return QWidget::eventFilter(watched, event);
}

关于WheelFocus无效的说明 #

WheelFocus只是设置控件可通过滚轮获取焦点，并不会改变事件传递逻辑。原生QTabBar处理滚轮事件后没有阻止事件冒泡，所以QScrollArea仍会收到该事件；而Spin Box、ComboBox这类控件在处理滚轮时会明确标记事件已处理，因此不会触发父控件的滚动。

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