PySide新闻流自定义ItemDelegate：文本自适应与交互问题

嘿，我看你在开发PySide新闻流的自定义ItemDelegate时碰到了两个棘手的问题：QTextEdit没法自动适配换行后的高度，原本的文本交互功能也丢失了，还出现了控件重叠的情况。咱们一步步来搞定这些问题：

问题根源分析 #

先拆解下你当前代码里的几个关键问题：

1. paint方法动态创建控件并渲染：这种方式只是把控件的像素画出来，并没有真正将控件添加到视图中，自然没有交互功能，而且每次paint都创建控件还特别低效。
2. sizeHint硬编码固定尺寸：完全没根据文本内容的实际长度（尤其是换行后的高度）计算item高度，直接导致了内容重叠。
3. QTextEdit默认不计算换行高度：QTextEdit的默认sizeHint只会返回固定高度，不会根据文本换行后的实际内容自动调整。

解决方案 #

如果需要完整的交互功能，用QListView.setIndexWidget为每个item绑定实际的Widget是最简单直接的方案；如果坚持用Delegate实现，虽然能搞定尺寸适配，但交互功能实现起来会复杂很多。这里优先推荐第一种方案，更贴合你的需求：

修改后的完整代码 #

import os, sys
from Qt import QtWidgets, QtCore, QtGui

class NewsItem(object):
    def __init__(self, **kwargs):
        super(NewsItem, self).__init__()
        self.title = kwargs.get('title', '')
        self.date = kwargs.get('date', '')
        self.content = kwargs.get('content', '')

class NewsItemWidget(QtWidgets.QWidget):
    """自定义新闻Item的Widget，包含标题和可交互文本内容"""
    def __init__(self, news_item, parent=None):
        super(NewsItemWidget, self).__init__(parent)
        self.news_item = news_item
        
        # 初始化标题控件
        self.title_label = QtWidgets.QLabel(news_item.title)
        self.title_label.setStyleSheet("font-weight: bold; font-size: 14px;")
        
        # 初始化可交互文本框
        self.content_edit = QtWidgets.QTextEdit(news_item.content)
        # 只读但保留选中文本、复制等交互功能
        self.content_edit.setReadOnly(True)
        # 开启自动换行
        self.content_edit.setWordWrapMode(QtGui.QTextOption.WordWrap)
        # 去掉边框和滚动条，让它更像纯文本显示控件
        self.content_edit.setFrameShape(QtWidgets.QFrame.NoFrame)
        self.content_edit.setVerticalScrollBarPolicy(QtCore.Qt.ScrollBarAlwaysOff)
        self.content_edit.setHorizontalScrollBarPolicy(QtCore.Qt.ScrollBarAlwaysOff)
        
        # 布局设置
        layout = QtWidgets.QVBoxLayout(self)
        layout.setContentsMargins(8, 8, 8, 8)
        layout.setSpacing(4)
        layout.addWidget(self.title_label)
        layout.addWidget(self.content_edit)
        
        # 监听视图宽度变化，动态调整文本框高度
        self.parent().widthChanged.connect(self.adjust_content_height)
        # 初始加载时先调整一次高度
        self.adjust_content_height()
    
    def adjust_content_height(self):
        """根据文本内容和当前宽度计算合适的高度"""
        # 计算可用宽度（减去布局边距）
        available_width = self.width() - self.layout().contentsMargins().left() - self.layout().contentsMargins().right()
        # 用QTextDocument计算文本实际高度
        doc = QtGui.QTextDocument(self.content_edit.toPlainText())
        doc.setTextWidth(available_width)
        # 设置文本框高度，加一点余量避免内容被截断
        self.content_edit.setFixedHeight(int(doc.size().height()) + 8)
        # 更新widget的尺寸提示
        self.updateGeometry()

class NewsListView(QtWidgets.QListView):
    widthChanged = QtCore.Signal()  # 自定义信号，通知item宽度变化
    
    def __init__(self, parent=None):
        super(NewsListView, self).__init__(parent)
        self.setModel(QtGui.QStandardItemModel(self))
        self.setEditTriggers(QtWidgets.QAbstractItemView.NoEditTriggers)
        self.setSizePolicy(QtWidgets.QSizePolicy.Expanding, QtWidgets.QSizePolicy.Preferred)
        # 关闭默认选中样式，用自定义widget的样式代替
        self.setSelectionMode(QtWidgets.QAbstractItemView.NoSelection)
    
    def resizeEvent(self, event):
        super(NewsListView, self).resizeEvent(event)
        # 视图宽度变化时发送信号
        self.widthChanged.emit()
    
    def setNewsItems(self, lst):
        self.model().clear()
        # 清空已有的indexWidget
        for index in self.model().match(self.model().index(0,0), QtCore.Qt.UserRole, None, -1, QtCore.Qt.MatchRecursive):
            self.setIndexWidget(index, None)
        
        for news_item in lst:
            item = QtGui.QStandardItem()
            item.setData(news_item, role=QtCore.Qt.UserRole)
            self.model().appendRow(item)
            # 为每个item绑定自定义widget
            widget = NewsItemWidget(news_item, self)
            self.setIndexWidget(item.index(), widget)
            # 把item的尺寸提示设为widget的尺寸提示，避免重叠
            item.setSizeHint(widget.sizeHint())

class MainWindow(QtWidgets.QMainWindow):
    def __init__(self):
        super(MainWindow, self).__init__()
        self.resize(350, 500)
        self.uiListView = NewsListView()
        self.setCentralWidget(self.uiListView)
    
    def unitTest(self):
        self.uiListView.setNewsItems([
            NewsItem(title='Big Update', date='Today', content='Something goes here...'),
            NewsItem(title='Smaller Update', date='Yesterday', content='Something goes here which should support word wrap. This is a longer content to test how the text edit adjusts its height automatically when the text wraps to multiple lines.'),
            NewsItem(title='Another Update', date='Last Year', content='Something goes here...'),
            NewsItem(title='Old Update', date='Unknown', content='Something goes here...'),
        ])

def main():
    app = QtWidgets.QApplication(sys.argv)
    ex = MainWindow()
    ex.unitTest()
    ex.show()
    sys.exit(app.exec_())

if __name__ == '__main__':
    main()

关键改动说明 #

1. 自定义NewsItemWidget：

   • 封装了标题和可交互的QTextEdit，设置为只读但保留选中文本、复制等功能。
   • 添加adjust_content_height方法，用QTextDocument精准计算文本在当前宽度下的实际高度，动态调整QTextEdit的高度。
   • 监听视图宽度变化，窗口或视图调整大小时自动重新计算高度，确保内容始终适配。

2. 改进NewsListView：

   • 新增widthChanged信号，在视图尺寸变化时通知所有item widget调整高度。
   • 用setIndexWidget为每个item绑定实际的widget，完美保留QTextEdit的所有交互功能。
   • 为每个model item设置尺寸提示为widget的尺寸提示，确保ListView正确计算每个item的高度，彻底解决重叠问题。

3. 移除原NewsItemDelegate：因为我们用实际的widget代替了Delegate的绘制逻辑，不需要再用Delegate渲染item了。

如果你坚持要用Delegate实现（仅尺寸适配，无交互） #

如果不需要交互功能，只是想正确绘制并适配尺寸，可以修改原Delegate的sizeHint和paint方法：

class NewsItemDelegate(QtWidgets.QStyledItemDelegate):
    def __init__(self, parent=None):
        super(NewsItemDelegate, self).__init__(parent)
        self.title_font = QtGui.QFont()
        self.title_font.setBold(True)
        self.title_font.setPointSize(14)
    
    def paint(self, painter, option, index):
        data = index.data(role=QtCore.Qt.UserRole)
        rect = option.rect.adjusted(8,8,-8,-8)
        
        # 绘制标题
        painter.save()
        painter.setFont(self.title_font)
        painter.drawText(rect.topLeft(), data.title)
        painter.restore()
        
        # 计算标题高度，绘制内容
        title_rect = QtGui.QFontMetrics(self.title_font).boundingRect(data.title)
        content_y = rect.top() + title_rect.height() + 4
        content_rect = QtCore.QRect(rect.left(), content_y, rect.width(), rect.height() - title_rect.height() -4)
        
        # 用QTextDocument绘制换行文本
        doc = QtGui.QTextDocument(data.content)
        doc.setTextWidth(content_rect.width())
        painter.save()
        painter.translate(content_rect.topLeft())
        doc.drawContents(painter)
        painter.restore()
        
        # 绘制选中状态（可选）
        if option.state & QtWidgets.QStyle.State_Selected:
            painter.fillRect(option.rect, option.palette.highlight())
    
    def sizeHint(self, option, index):
        data = index.data(role=QtCore.Qt.UserRole)
        available_width = option.rect.width() - 16  # 减去左右边距
        
        # 计算标题高度
        title_height = QtGui.QFontMetrics(self.title_font).boundingRect(data.title).height()
        
        # 计算内容高度
        doc = QtGui.QTextDocument(data.content)
        doc.setTextWidth(available_width)
        content_height = doc.size().height()
        
        # 总高度 = 标题高度 + 内容高度 + 边距和间距
        total_height = title_height + content_height + 20  # 上下边距各8，间距4
        return QtCore.QSize(available_width +16, int(total_height))

这种方式能正确适配尺寸，但没有交互功能，因为只是绘制文本而非实际控件。

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