如何让QToolButton选择性对鼠标滚轮事件透明并保留点击事件响应能力

我刚好遇到过类似的需求，Qt::WA_TransparentForMouseEvents确实会把所有鼠标事件都透传给下层组件，连点击事件也会被忽略，完全不符合你的要求。这里有两种靠谱的解决方案，你可以根据场景选择：

方法一：子类化QToolButton，重写滚轮事件处理 #

这种方法最干净，适合需要在多个地方复用这种特殊按钮的场景：

#include <QToolButton>
#include <QWheelEvent>

class PassWheelToolButton : public QToolButton
{
    Q_OBJECT
protected:
    void wheelEvent(QWheelEvent *event) override
    {
        // 不对滚轮事件做任何处理，标记为"未处理"让事件继续向下传递给下层QDial
        event->ignore();
        
        // （可选）如果你想确保事件精准传递给目标QDial，可直接调用它的wheelEvent
        // 前提是能拿到QDial指针，比如通过父部件查找：
        // QDial* targetDial = qobject_cast<QDial*>(this->parentWidget());
        // if (targetDial) {
        //     targetDial->wheelEvent(event);
        // }
    }
};

之后把UI里的QToolButton替换成这个自定义类，或者用代码创建实例即可。它会正常响应点击、悬停等所有鼠标事件，唯独把滚轮事件留给下面的QDial处理。

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

如果你不想自定义按钮类，只需要给单个按钮实现功能，事件过滤器是更灵活的选择：

1. 先在窗口类构造函数里给按钮安装事件过滤器：

ui->toolButton_Example->installEventFilter(this);

2. 重写窗口类的eventFilter方法，拦截并转发滚轮事件：

#include <QEvent>
#include <QWheelEvent>
#include <QDial>

bool YourMainWindow::eventFilter(QObject *watched, QEvent *event)
{
    // 只处理目标按钮的滚轮事件
    if (watched == ui->toolButton_Example && event->type() == QEvent::Wheel)
    {
        QWheelEvent* wheelEvent = static_cast<QWheelEvent*>(event);
        // 替换成你实际的QDial对象指针
        QDial* targetDial = ui->yourDialWidget;
        
        if (targetDial)
        {
            // 转换事件坐标：把按钮坐标系下的位置转换成QDial的坐标系
            QPoint globalPos = wheelEvent->globalPosition().toPoint();
            QPoint dialLocalPos = targetDial->mapFromGlobal(globalPos);
            
            // 创建适配QDial的新滚轮事件并发送
            QWheelEvent adaptedEvent(
                dialLocalPos, wheelEvent->globalPosition(),
                wheelEvent->pixelDelta(), wheelEvent->angleDelta(),
                wheelEvent->buttons(), wheelEvent->modifiers(),
                wheelEvent->phase(), wheelEvent->inverted(),
                wheelEvent->source()
            );
            QCoreApplication::sendEvent(targetDial, &adaptedEvent);
        }
        // 返回true表示事件已处理，按钮不会再响应它
        return true;
    }
    // 其他事件交给父类处理
    return QMainWindow::eventFilter(watched, event);
}

这个方法的核心是拦截按钮的滚轮事件，将其转换为适配QDial坐标系的事件后直接发送，同时让按钮正常处理点击等其他鼠标事件。

为什么Qt::WA_TransparentForMouseEvents不行？ #

这个属性的作用是让组件完全忽略所有鼠标事件，所有事件都会直接透传给下层组件——自然也包括点击事件，这就是你遇到按钮无法响应clicked()信号的原因，它完全不符合你"只透传滚轮"的需求。

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