WindowsVista样式下Qt控件Hover时出现闪烁/抖动问题求助

问题概述 #

我们将应用从Qt 5.6.3升级至Qt 6.8.2（Qt 6.9.1也存在相同问题），使用MSVC2022 64位编译，运行于Windows 11/10系统。当应用样式设置为windowsvista时，鼠标悬停在QSpinBox、QCheckBox、QRadioButton等控件上会出现闪烁/抖动现象。

经测试，该问题仅在非整数倍DPI缩放时触发：

• 100%、200%、300%缩放：无异常
• 150%缩放：所有测试控件均抖动
• 225%缩放：仅QSpinBox出现抖动

因客观限制无法更换其他样式，且已解决qwindowsvistastyle.dll的加载问题。

环境信息 #

• Qt版本：6.8.2 / 6.9.1
• 编译器：MSVC2022 64位
• 操作系统：Windows 11/10
• 应用样式：windowsvista

复现代码 #

#include <QApplication>
#include <QStyleFactory>
#include <QSpinBox>
#include <QVBoxLayout>
#include <QCheckBox>
#include <QMainWindow>
#include <QRadioButton>

int main(int argc, char *argv[])
{
    auto a = QApplication(argc, argv);
    a.setStyle(QStyleFactory::create("windowsvista"));

    auto w = QMainWindow();

    auto* l = new QVBoxLayout();
    l->addWidget(new QSpinBox());
    l->addWidget(new QCheckBox());
    l->addWidget(new QRadioButton());

    auto* top = new QWidget();
    top->setLayout(l);

    w.setCentralWidget(top);

    w.show();
    return a.exec();
}

解决方案 #

方案1：调整Qt高DPI缩放策略 #

在QApplication初始化前添加高DPI相关设置，强制Qt对缩放因子进行取整处理，避免小数像素导致的重绘抖动：

#include <QApplication>
#include <QStyleFactory>
#include <QSpinBox>
#include <QVBoxLayout>
#include <QCheckBox>
#include <QMainWindow>
#include <QRadioButton>

int main(int argc, char *argv[])
{
    // 启用高DPI缩放并设置取整策略
    QApplication::setAttribute(Qt::AA_EnableHighDpiScaling);
    QApplication::setAttribute(Qt::AA_UseHighDpiPixmaps);
    QApplication::setHighDpiScaleFactorRoundingPolicy(Qt::HighDpiScaleFactorRoundingPolicy::RoundPreferFloor);

    auto a = QApplication(argc, argv);
    a.setStyle(QStyleFactory::create("windowsvista"));

    auto w = QMainWindow();

    auto* l = new QVBoxLayout();
    l->addWidget(new QSpinBox());
    l->addWidget(new QCheckBox());
    l->addWidget(new QRadioButton());

    auto* top = new QWidget();
    top->setLayout(l);

    w.setCentralWidget(top);

    w.show();
    return a.exec();
}

这个设置让Qt使用整数缩放因子，减少控件绘制时的像素偏移，从而缓解闪烁问题。

方案2：自定义WindowsVista样式优化绘制 #

如果方案1无效，可以继承QWindowsVistaStyle，重写控件绘制逻辑，强制悬停状态下的控件绘制区域对齐到整数像素：

#include <QWindowsVistaStyle>
#include <QPainterPath>

class FixedWindowsVistaStyle : public QWindowsVistaStyle
{
protected:
    void drawPrimitive(PrimitiveElement pe, const QStyleOption *opt, QPainter *p, const QWidget *w) const override
    {
        // 针对复选框、单选框、SpinBox上下按钮的悬停状态处理
        if ((pe == PE_IndicatorCheckBox || pe == PE_IndicatorRadioButton || 
             pe == PE_SpinBoxUp || pe == PE_SpinBoxDown) && 
            (opt->state & State_MouseOver)) {
            // 将绘制区域对齐到整数像素
            QRect alignedRect = opt->rect.toAlignedRect();
            QStyleOption alignedOpt = *opt;
            alignedOpt.rect = alignedRect;
            QWindowsVistaStyle::drawPrimitive(pe, &alignedOpt, p, w);
            return;
        }
        QWindowsVistaStyle::drawPrimitive(pe, opt, p, w);
    }
};

然后在应用中替换原有样式：

// 替换原有的a.setStyle(QStyleFactory::create("windowsvista"));
a.setStyle(new FixedWindowsVistaStyle());

通过强制像素对齐，避免因小数像素导致的重复重绘和抖动。

方案3：检查官方补丁或升级Qt版本 #

该问题属于Qt官方样式的已知bug，可前往Qt官方bug跟踪平台查询是否有对应补丁；也可以尝试升级到Qt 6的最新版本，看官方是否已修复该问题。

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