如何设置QPdfView的viewport背景色？

问题说明 #

QPdfView 继承自 QAbstractScrollArea，但直接使用样式表无法修改其 viewport 的背景色，具体表现为：

• 给 QPdfView 本身设置样式表（background: white 或 QWidget{background: white;}），仅能改变组件边框区域的背景，viewport 仍为灰色
• 直接调用 viewport()->setStyleSheet("background: white") 无效果
• 重写 paintEvent 会在 PDF 内容上层绘制，导致文档被覆盖

解决方案（无需重写paintEvent） #

方法1：通过调色板（Palette）设置背景色 #

直接修改 viewport 的调色板并开启自动填充背景，这是最可靠的方式：

#include <QApplication>
#include <QPdfView>
#include <QPalette>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    QPdfView *pdfView = new QPdfView();
    pdfView->setMinimumSize(100,100);

    // 设置viewport背景色
    pdfView->viewport()->setAutoFillBackground(true);
    QPalette palette = pdfView->viewport()->palette();
    palette.setColor(QPalette::Window, Qt::white); // 替换为你需要的颜色
    pdfView->viewport()->setPalette(palette);

    pdfView->show();
    return a.exec();
}

方法2：使用精确的样式表选择器 #

利用 QAbstractScrollArea 的 viewport 对象名（#viewport）编写样式表，直接定位到目标组件：

#include <QApplication>
#include <QPdfView>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    QPdfView *pdfView = new QPdfView();
    pdfView->setMinimumSize(100,100);

    // 精确匹配QPdfView的viewport组件
    pdfView->setStyleSheet(R"(
        QPdfView QAbstractScrollArea#viewport {
            background-color: white;
        }
    )");

    pdfView->show();
    return a.exec();
}

为什么之前的样式表写法无效？ #

QPdfView 的 viewport 并非直接响应顶层 QWidget 或 QPdfView 的样式规则，因为它是 QAbstractScrollArea 内部的子组件，需要通过对象名选择器或直接操作调色板才能生效。而直接给 viewport 设置样式表无效，是因为 QPdfView 内部的页面渲染逻辑可能会覆盖 viewport 的样式设置，调色板的优先级更高。

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