Windows11下QPushButton:hover样式不生效问题求助

核心原因 #

Windows11下Qt默认启用QWindowsStyle（系统原生样式），该样式会优先调用系统主题的控件渲染逻辑。仅设置background属性时，常规状态下样式表可生效，但hover状态会被系统主题内置的悬停颜色（你看到的白色）覆盖——原生样式的状态绘制优先级高于部分样式表属性。

可行解决方案 #

方案1：强制触发纯样式表绘制 #

通过添加border属性让Qt完全用样式表渲染按钮，规避原生样式干扰。修改后的样式表示例：

QPushButton {
    border: none; /* 也可设置具体边框样式，如 border: 1px solid #888; */
    background: red;
}
QPushButton:hover {
    background: blue;
}

若需保留类似原生按钮的边框质感，可调整边框参数：

QPushButton {
    border: 1px solid #ccc;
    border-radius: 4px;
    background: red;
    padding: 3px 10px;
}
QPushButton:hover {
    background: blue;
}

方案2：启用WA_StyledBackground属性 #

在代码中给目标按钮设置属性，强制Qt使用样式表绘制背景：

yourPushButton->setAttribute(Qt::WA_StyledBackground, true);

设置后再应用原样式表，hover状态的背景色即可正常生效。

方案3：自定义系统样式（进阶） #

若需保留Windows原生样式的大部分特性，仅修改hover背景，可继承QWindowsStyle并重写drawControl方法，针对CE_PushButton的hover状态自定义绘制逻辑。此方式代码量较大，适合深度定制场景。

关于默认hover颜色的来源 #

你看到的白色hover背景，是Windows11系统主题中定义的按钮悬停颜色，由QWindowsStyle从系统视觉样式数据库中读取。当样式表未完全接管按钮绘制时，原生样式会优先使用该系统颜色。

内容的提问来源于stack exchange，提问作者Timothée Soriano