如何在QTableView中利用QTextDocument实现HTML文本自动换行

问题概述 #

为QTableView实现了基于QTextDocument的HTML绘制代理类，用于在表格中展示HTML文本，但存在HTML字符串无法自动换行的问题。未使用该代理时，表格原生自动换行功能正常；参考资料添加QTextDocument的自动换行设置后，问题仍未解决。

问题根源 #

1. 配置的QTextOption未真正绑定到QTextDocument对象，仅创建了配置对象但未应用到文档
2. 未限制QTextDocument的宽度，导致文档无法识别单元格的边界位置，无法触发换行逻辑

修复后的代理类代码 #

class HtmlPainter(QtWidgets.QStyledItemDelegate):
    def __init__(self, parent=None):
        super().__init__(parent)

    def paint(self, painter, option, index):
        if index.column() == 1: 
            text = index.model().data(index)
            palette = QtWidgets.QApplication.palette()
            document = QtGui.QTextDocument()
            document.setDefaultFont(option.font)
            
            # 正确配置自动换行并应用到文档
            text_option = QtGui.QTextOption(document.defaultTextOption())
            text_option.setWrapMode(QtGui.QTextOption.WordWrap)
            document.setDefaultTextOption(text_option)
            
            # 根据选中状态设置带颜色的HTML文本
            if option.state & QtWidgets.QStyle.State_Selected:  
                display_string = f"<font color={palette.highlightedText().color().name()}>{text}</font>"
                document.setHtml(display_string)
            else:
                document.setHtml(text)
            
            # 限制文档宽度为单元格宽度，触发自动换行
            document.setTextWidth(option.rect.width())
            
            # 绘制单元格背景
            bg_color = palette.highlight().color() if (option.state & QtWidgets.QStyle.State_Selected) else palette.base().color()
            painter.save()
            painter.fillRect(option.rect, bg_color)
            # 平移绘制起点到单元格左上角
            painter.translate(option.rect.x(), option.rect.y())
            # 在单元格范围内绘制文档内容
            document.drawContents(painter, QtCore.QRectF(0, 0, option.rect.width(), option.rect.height()))
            painter.restore()
        else:
            super().paint(painter, option, index)

核心修复说明 #

• 绑定文本配置：添加document.setDefaultTextOption(text_option)，让自动换行设置真正生效
• 设置文档宽度：通过document.setTextWidth(option.rect.width())明确告诉文档单元格的宽度边界
• 精准绘制范围：调用drawContents时指定单元格的矩形范围，确保内容完全在单元格内展示
• 代码优化：使用super()简化父类调用，用f-string优化字符串拼接逻辑

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