如何在QTableWidget表头中设置上标？

问题背景 #

QLabel中使用HTML标签（如<sup>实现上标，示例：µm<sup>2</sup>）可正常渲染，但将相同内容设置到QTableWidgetItem时，HTML标签会被当作纯文本显示，所有QLabel支持的HTML标签均无法生效。

解决方案 #

方案1：嵌入QLabel到单元格（快速实现） #

QLabel原生支持HTML解析，直接将其作为单元格控件插入即可：

// 定位目标单元格（示例为第0行第0列）
int targetRow = 0;
int targetCol = 0;
// 创建带HTML文本的QLabel
QLabel* htmlLabel = new QLabel("µm<sup>2</sup>");
htmlLabel->setAlignment(Qt::AlignVCenter | Qt::AlignHCenter); // 可选：设置文本居中
// 将标签绑定到单元格
ui->tableWidget->setCellWidget(targetRow, targetCol, htmlLabel);

方案2：自定义委托实现批量富文本渲染 #

若需批量处理大量单元格，推荐使用自定义ItemDelegate，让QTableWidget全局支持HTML解析：

#include <QStyledItemDelegate>
#include <QTextDocument>

class HtmlRenderDelegate : public QStyledItemDelegate
{
protected:
    void paint(QPainter* painter, const QStyleOptionViewItem& option, const QModelIndex& index) const override
    {
        QStyleOptionViewItem opt = option;
        initStyleOption(&opt, index);

        // 先绘制单元格样式，再单独渲染HTML文本
        painter->save();
        opt.text = ""; // 清空默认文本，避免重复绘制
        QStyledItemDelegate::paint(painter, opt, index);

        QTextDocument doc;
        doc.setHtml(index.data(Qt::DisplayRole).toString());
        // 调整绘制区域
        painter->translate(opt.rect.left(), opt.rect.top());
        doc.drawContents(painter, QRectF(0, 0, opt.rect.width(), opt.rect.height()));
        painter->restore();
    }

    QSize sizeHint(const QStyleOptionViewItem& option, const QModelIndex& index) const override
    {
        QStyleOptionViewItem opt = option;
        initStyleOption(&opt, index);
        QTextDocument doc;
        doc.setHtml(opt.text);
        doc.setTextWidth(opt.rect.width());
        return QSize(doc.idealWidth(), doc.size().height());
    }
};

使用方式：

// 给表格设置自定义委托
ui->tableWidget->setItemDelegate(new HtmlRenderDelegate());
// 直接给Item设置HTML文本即可生效
ui->tableWidget->item(targetRow, targetCol)->setText("µm<sup>2</sup>");

内容的提问来源于stack exchange，提问作者Parisa.H.R