QTableView横竖表头打印问题：转置后无法打印垂直表头

我之前做Qt项目时也碰到过转置模型打印垂直表头的问题，Qt自带的QTableView::print()方法确实不会自动适配这种代理模型转置后的场景，毕竟默认逻辑是针对常规行列结构的。下面给你几个实用的解决方案，亲测有效：

核心思路 #

转置后的代理模型把原SQL结果的列名变成了垂直表头内容，而Qt默认打印只会渲染水平表头和表格体，所以必须手动实现打印逻辑，把垂直表头也绘制进去。

具体实现方案 #

我推荐自定义打印函数，用QPainter手动绘制所有元素，这样完全可控。下面是完整的示例代码：

void printTransposedTable(QTableView *view) {
    QPrinter printer(QPrinter::HighResolution);
    QPrintDialog dialog(&printer, view);
    if (dialog.exec() != QDialog::Accepted) return;

    QPainter painter(&printer);
    painter.setRenderHint(QPainter::Antialiasing);

    QAbstractItemModel *model = view->model();
    const int rowCount = model->rowCount();
    const int colCount = model->columnCount();

    // 配置字体：表头用加粗字体
    QFont headerFont = painter.font();
    headerFont.setBold(true);
    const QFontMetrics headerMetrics(headerFont);
    const QFontMetrics contentMetrics(painter.font());

    // 计算垂直表头的宽度（取所有垂直表头文本的最大宽度，加边距）
    int verticalHeaderWidth = 0;
    for (int row = 0; row < rowCount; ++row) {
        const QString headerText = model->headerData(row, Qt::Vertical).toString();
        verticalHeaderWidth = qMax(verticalHeaderWidth, headerMetrics.horizontalAdvance(headerText));
    }
    verticalHeaderWidth += 10; // 增加左右边距

    // 计算每列的宽度（兼顾水平表头和单元格内容的宽度）
    QVector<int> columnWidths(colCount);
    for (int col = 0; col < colCount; ++col) {
        int colWidth = headerMetrics.horizontalAdvance(model->headerData(col, Qt::Horizontal).toString());
        for (int row = 0; row < rowCount; ++row) {
            const QString cellText = model->data(model->index(row, col)).toString();
            colWidth = qMax(colWidth, contentMetrics.horizontalAdvance(cellText));
        }
        columnWidths[col] = colWidth + 10;
    }

    // 计算行高（取表头和内容字体的最大高度，加上下边距）
    const int rowHeight = qMax(headerMetrics.height(), contentMetrics.height()) + 8;

    // 初始化绘制坐标
    int xPos = 20;
    int yPos = 20;

    // 第一步：绘制垂直表头
    painter.setFont(headerFont);
    for (int row = 0; row < rowCount; ++row) {
        const QString headerText = model->headerData(row, Qt::Vertical).toString();
        painter.drawText(xPos, yPos, verticalHeaderWidth, rowHeight, Qt::AlignCenter, headerText);
        yPos += rowHeight;
    }

    // 重置Y坐标，准备绘制水平表头和表格内容
    yPos = 20;
    xPos += verticalHeaderWidth;

    // 第二步：绘制水平表头
    for (int col = 0; col < colCount; ++col) {
        const QString headerText = model->headerData(col, Qt::Horizontal).toString();
        painter.drawText(xPos, yPos, columnWidths[col], rowHeight, Qt::AlignCenter, headerText);
        xPos += columnWidths[col];
    }

    // 第三步：绘制表格内容
    painter.setFont(view->font());
    for (int row = 0; row < rowCount; ++row) {
        xPos = 20 + verticalHeaderWidth;
        yPos += rowHeight;
        for (int col = 0; col < colCount; ++col) {
            const QString cellText = model->data(model->index(row, col)).toString();
            painter.drawText(xPos, yPos, columnWidths[col], rowHeight, Qt::AlignCenter, cellText);
            xPos += columnWidths[col];
        }
    }
}

代码说明 #

• 先通过QPrintDialog让用户选择打印参数，确保交互友好。
• 计算各元素的尺寸时，兼顾了文本长度和边距，避免内容被截断。
• 分三步绘制：垂直表头→水平表头→表格内容，保证排版整齐。
• 因为用的是代理模型的headerData和data方法，所以自动适配转置后的结构，不需要额外处理索引转换。

进阶优化 #

如果你的表格内容较多，需要分页的话，可以在绘制前计算总高度，和打印机页面高度对比，超过时调用printer.newPage()创建新页，然后重复绘制逻辑（注意调整Y坐标）。

另外，也可以根据需求修改字体、对齐方式、边距等参数，让打印效果和你的UI风格统一。

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