PyQt5 QTableWidget实现文本自动换行的技术问询

要实现QTableWidget中长文本自动换行，只需配置三个关键设置：开启表格自动换行功能、设置单元格文本的换行对齐方式、让行高自动适应内容高度。

步骤说明： #

• 开启表格的wordWrap属性，允许文本换行
• 给需要换行的QTableWidgetItem设置文本对齐方式为AlignTop | TextWordWrap，确保文本顶部对齐并自动换行
• 设置垂直表头的行高调整模式为ResizeToContents，让行高自动适配换行后的文本高度

修改后的完整代码： #

import PyQt5.QtWidgets as qtw
import PyQt5.QtCore as qtc
import PyQt5.QtGui as qtg

class MainWindow(qtw.QMainWindow):
    def __init__(self):
         super().__init__()
         self.window_width, self.window_height = 300, 200
         self.resize(self.window_width, self.window_height)
    
         layout = qtw.QVBoxLayout()
    
         self.table = qtw.QTableWidget()
         # 开启表格自动换行
         self.table.setWordWrap(True)
         # 设置垂直表头自动调整行高
         self.table.verticalHeader().setSectionResizeMode(qtw.QHeaderView.ResizeToContents)
         layout.addWidget(self.table)
    
         self.button = qtw.QPushButton('&Load Data')
         layout.addWidget(self.button)
    
         widget = qtw.QWidget()
         widget.setLayout(layout)
         self.setCentralWidget(widget)
    
         self.button.clicked.connect(self.Set)

         self.show()
    def Set(self):
         string0 = 'These is String zero'
         string1 = 'This is a super long text that should be displayed using line breaks. This is a super long text that should be displayed using line breaks.'
    
         self.table.setRowCount(2)
         self.table.setColumnCount(2)
         self.table.setHorizontalHeaderLabels(['String1', 'String2'])
    
         # 普通文本单元格
         item0 = qtw.QTableWidgetItem(string0)
         item0.setTextAlignment(qtc.Qt.AlignTop | qtc.Qt.AlignLeft)
         self.table.setItem(0,0, item0)
    
         # 长文本换行单元格
         item1 = qtw.QTableWidgetItem(string1)
         # 设置文本对齐为顶部对齐+自动换行
         item1.setTextAlignment(qtc.Qt.AlignTop | qtc.Qt.TextWordWrap)
         self.table.setItem(0,1, item1)

if __name__== '__main__':
    import sys
    app = qtw.QApplication(sys.argv)
    window = MainWindow()
    sys.exit(app.exec_())

补充：复杂文本渲染方案 #

如果需要处理富文本或更精细控制文本样式，可以自定义QStyledItemDelegate实现绘制逻辑：

class WrapTextDelegate(qtw.QStyledItemDelegate):
    def paint(self, painter, option, index):
        text = index.data(qtc.Qt.DisplayRole)
        doc = qtg.QTextDocument()
        doc.setPlainText(text)
        doc.setTextWidth(option.rect.width())
        painter.save()
        # 调整绘制位置，避免文本紧贴单元格边框
        painter.translate(option.rect.x(), option.rect.y())
        doc.drawContents(painter)
        painter.restore()

# 在MainWindow的__init__中添加委托设置：
self.table.setItemDelegate(WrapTextDelegate())

使用该方案时同样需要开启行高自动调整，确保内容完整显示。

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