QTableView如何实现内容不足时拉伸、过长时显示滚动条？

要实现这个需求，核心是动态判断内容总宽度与表格可用宽度的关系，调整最后一列的拉伸属性。具体实现步骤如下：

1. 关闭文本省略模式，确保长内容能完整显示
2. 编写方法计算所有列的内容总宽度，与表格可用宽度对比，动态切换最后一列的拉伸状态
3. 在表格初始化、大小变化、内容更新时触发状态检查，保证实时同步

修改后的完整代码 #

import sys

from PySide6.QtCore import Qt, QEvent
from PySide6.QtWidgets import (
    QApplication,
    QTableWidget,
    QTableWidgetItem,
    QHeaderView,
    QHBoxLayout,
    QDialog,
    QAbstractItemView,
)


class TableList(QTableWidget):
    def __init__(self, *args):
        super().__init__(*args)

        self.setSelectionBehavior(QAbstractItemView.SelectionBehavior.SelectRows)
        self.setSelectionMode(QAbstractItemView.SelectionMode.SingleSelection)
        self.setAlternatingRowColors(True)

        # 关闭文本省略，确保长内容完整显示
        self.setTextElideMode(Qt.ElideNone)

        self.horizontalHeader().hide()
        self.verticalHeader().hide()

        self.setTabKeyNavigation(False)

        h_header = self.horizontalHeader()
        h_header.setSectionResizeMode(QHeaderView.ResizeMode.ResizeToContents)
        
        # 初始化时检查拉伸状态
        self.adjust_last_section_stretch()

        # 监听表格大小变化
        self.installEventFilter(self)
        # 监听内容变化
        self.model().dataChanged.connect(self.adjust_last_section_stretch)

    def adjust_last_section_stretch(self):
        h_header = self.horizontalHeader()
        # 计算所有列的内容总宽度
        total_content_width = sum(h_header.sectionSize(col) for col in range(self.columnCount()))
        # 表格的可用宽度（去除边框等额外宽度）
        table_available_width = self.viewport().width()

        if total_content_width <= table_available_width:
            h_header.setStretchLastSection(True)
        else:
            h_header.setStretchLastSection(False)
            # 确保水平滚动条按需显示
            self.setHorizontalScrollBarPolicy(Qt.ScrollBarPolicy.ScrollBarAsNeeded)

    def eventFilter(self, obj, event):
        # 处理表格大小变化事件
        if obj == self and event.type() == QEvent.Type.Resize:
            self.adjust_last_section_stretch()
        return super().eventFilter(obj, event)


class MainWindow(QDialog):
    def __init__(self):
        super().__init__()

        self.table = TableList()
        self.table.setColumnCount(3)
        self.table.setRowCount(1)

        self.table.setItem(0, 0, QTableWidgetItem("A"))
        self.table.setItem(0, 1, QTableWidgetItem("This is a longer text"))
        self.table.setItem(0, 2, QTableWidgetItem("This is another long text"))

        self.table.setFixedWidth(250)

        layout = QHBoxLayout()
        layout.addWidget(self.table)
        self.setLayout(layout)


app = QApplication(sys.argv)
window = MainWindow()
window.show()
app.exec()

关键逻辑说明 #

• adjust_last_section_stretch：核心方法，通过对比内容总宽度和表格可用宽度，决定是否开启最后一列拉伸
• 事件过滤器：监听表格大小变化，实时触发拉伸状态调整
• 内容变化监听：连接dataChanged信号，确保内容更新后自动重新计算
• 关闭文本省略：通过setTextElideMode(Qt.ElideNone)避免长内容被截断为“...”

这样就能实现预期效果：内容总宽度小于表格宽度时，最后一列拉伸填充空白；内容总宽度超过表格宽度时，显示水平滚动条，所有内容完整展示。

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