如何在QHeaderView的paintSection中绘制QPixmap？绘制失效问题求助

我看了你的代码，问题主要出在绘制顺序和一些细节处理上，咱们一步步来修复：

1. 调整绘制顺序（核心问题） #

你现在是先绘制pixmap，再调用QHeaderView::paintSection——但父类的这个方法会绘制表头的默认背景、文字等内容，直接把你画的图片覆盖掉了！

正确的做法是先调用父类的paintSection完成基础绘制，再叠加自己的图片，这样你的图片会显示在默认内容之上；如果想让图片作为背景，那就得在父类绘制前画，同时调整父类的绘制逻辑避免覆盖。

修改后的paintSection函数：

void paintSection(QPainter *painter, const QRect &rect, int logicalIndex) const override
{
    // 先让父类完成表头的基础绘制（背景、文字等）
    QHeaderView::paintSection(painter, rect, logicalIndex);

    switch (logicalIndex) 
    {
        case 0:
        {
            // 先检查图片是否加载成功，避免无效绘制
            if (!pixmap.isNull()) {
                // 直接填充整个表头区域
                painter->drawPixmap(rect, pixmap, pixmap.rect());
                // 如果要保持图片比例居中显示，可以用这段代码替换上面的drawPixmap：
                // QPixmap scaledPix = pixmap.scaled(rect.size(), Qt::KeepAspectRatio, Qt::SmoothTransformation);
                // painter->drawPixmap(rect.center() - scaledPix.rect().center(), scaledPix);
            }
            qDebug() << rect;
            break;
        }
        default:
            break;
    }
}

2. 确保Pixmap正确加载 #

你把pixmap直接作为类成员初始化，可能会遇到资源还未加载完成的问题，建议移到构造函数里初始化，同时增加加载状态检查方便调试：

class HeaderView : public QHeaderView
{
    Q_OBJECT
public:
    HeaderView(Qt::Orientation orientation, QWidget *parent = nullptr)
        : QHeaderView(orientation, parent)
    {
        // 移到构造函数初始化图片
        pixmap = QPixmap(":/files/icon.png");
        // 检查是否加载成功，路径错误时会输出警告
        if (pixmap.isNull()) {
            qWarning() << "Failed to load pixmap from :/files/icon.png";
        }
    }

    QPixmap pixmap; // 仅声明，初始化交给构造函数

    // ... 其他代码
};

3. 额外优化：让图片作为表头背景 #

如果你的需求是让图片作为表头背景（替代默认背景），而不是叠加在文字上，可以用下面的写法：

void paintSection(QPainter *painter, const QRect &rect, int logicalIndex) const override
{
    switch (logicalIndex) 
    {
        case 0:
        {
            if (!pixmap.isNull()) {
                // 先绘制背景图片
                painter->drawPixmap(rect, pixmap, pixmap.rect());
            }
            // 手动构造样式选项，设置透明背景避免覆盖图片
            QStyleOptionHeader opt;
            initStyleOption(&opt);
            opt.palette.setBrush(QPalette::Button, Qt::transparent);
            // 调用样式绘制表头（不含背景）
            style()->drawControl(QStyle::CE_HeaderSection, &opt, painter, this);
            // 手动绘制表头文字
            QString text = model()->headerData(logicalIndex, orientation(), Qt::DisplayRole).toString();
            painter->drawText(rect, Qt::AlignCenter, text);
            qDebug() << rect;
            return; // 跳过父类默认绘制
        }
        default:
            break;
    }

    // 其他列使用默认绘制逻辑
    QHeaderView::paintSection(painter, rect, logicalIndex);
}

验证TreeView的初始化逻辑 #

你的TreeView代码没问题，不过可以调整下设置顺序（不影响功能，但逻辑更清晰）：

TreeView(QWidget* parent = 0) : QTreeView(parent)
{
    headerView = new HeaderView(Qt::Horizontal);
    setHeader(headerView); // 先设置自定义表头，再绑定模型

    model.setHorizontalHeaderItem(0, new QStandardItem("column0"));
    model.setHorizontalHeaderItem(1, new QStandardItem("column1"));
    model.setHorizontalHeaderItem(2, new QStandardItem("column2"));

    setModel(&model);
    setIndentation(0);
    setUniformRowHeights(true);
    setRootIsDecorated(false);
    setSortingEnabled(true);

    header()->setDefaultAlignment(Qt::AlignCenter);
    header()->setMinimumSectionSize(100);
}

按照上面的步骤修改后，你的QPixmap应该就能正常显示在表头第一列了。

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