Qt5.15.8中Styled ScrollView作为组件使用时出现视觉伪影求助

问题确认 #

这是Qt5.15.x版本中ScrollView样式绘制的已知兼容性问题：当自定义样式的ScrollBar作为组件（内联或独立文件）复用/嵌套时，悬停交互会触发原生ScrollBar的局部绘制逻辑，导致未样式化的伪影出现，表现为悬停垂直ScrollBar时水平ScrollBar左上角出现伪影，反之亦然，特定时机下两者伪影可同时显现。

修复方案 #

1. 强制覆盖ScrollBar全状态样式 #

在ScrollView的样式表中，为ScrollBar的所有交互状态（normal、hover、pressed）及子元素（滑块、箭头按钮等）明确定义样式，避免Qt fallback到原生样式：

/* 垂直滚动条基础样式 */
ScrollView QScrollBar:vertical {
    background: #f0f0f0;
    width: 12px;
}
ScrollView QScrollBar:vertical:hover {
    background: #e0e0e0;
}
/* 水平滚动条基础样式 */
ScrollView QScrollBar:horizontal {
    background: #f0f0f0;
    height: 12px;
}
ScrollView QScrollBar:horizontal:hover {
    background: #e0e0e0;
}
/* 滑块全状态样式 */
ScrollView QScrollBar::handle:vertical {
    background: #888;
    border-radius: 6px;
}
ScrollView QScrollBar::handle:vertical:hover {
    background: #666;
}
ScrollView QScrollBar::handle:horizontal {
    background: #888;
    border-radius: 6px;
}
ScrollView QScrollBar::handle:horizontal:hover {
    background: #666;
}
/* 隐藏箭头按钮（按需选择） */
ScrollView QScrollBar::add-line, ScrollView QScrollBar::sub-line {
    background: none;
    border: none;
}

2. 禁用ScrollBar原生绘制优化 #

在ScrollView初始化代码中，强制关闭滚动条的原生渲染优化，确保自定义样式完全生效：

QScrollBar* vScrollBar = scrollView->verticalScrollBar();
QScrollBar* hScrollBar = scrollView->horizontalScrollBar();

// 强制重载样式表，覆盖原生逻辑
vScrollBar->setStyleSheet(vScrollBar->styleSheet());
hScrollBar->setStyleSheet(hScrollBar->styleSheet());

// 强制使用样式化背景
vScrollBar->setAttribute(Qt::WA_StyledBackground, true);
hScrollBar->setAttribute(Qt::WA_StyledBackground, true);

3. 规避组件嵌套样式继承冲突 #

若ScrollView为独立组件（.ui文件或自定义类），设置样式时使用局部选择器（如ScrollView#myCustomScrollView），避免父容器的全局样式干扰组件内部滚动条的样式渲染。

4. 手动覆盖伪影区域（极端场景） #

若上述方案无效，可重写QScrollView的paintEvent，手动覆盖伪影区域：

void CustomScrollView::paintEvent(QPaintEvent* event) {
    QScrollView::paintEvent(event);
    QPainter painter(this);
    const QColor bgColor = palette().background().color();

    // 覆盖水平滚动条左上角伪影
    if (horizontalScrollBar()->isVisible()) {
        QRect shadowRect(0, height() - horizontalScrollBar()->height(),
                         verticalScrollBar()->width(), horizontalScrollBar()->height());
        painter.fillRect(shadowRect, bgColor);
    }
    // 覆盖垂直滚动条右上角伪影
    if (verticalScrollBar()->isVisible()) {
        QRect shadowRect(width() - verticalScrollBar()->width(), 0,
                         verticalScrollBar()->width(), horizontalScrollBar()->height());
        painter.fillRect(shadowRect, bgColor);
    }
}

内容的提问来源于stack exchange，提问作者Tobias Sch.