PyQt5自定义QHeaderView后表头消失，如何实现列宽最小限制？

我尝试通过子类化PyQt5的QHeaderView，为QTableWidget的列设置最小宽度约束，但运行run_me.py时发现表头完全不可见。相关代码如下：

文件：table.py

from PyQt5 import QtCore, QtGui, QtWidgets

class Ui_Dialog(object):
    def setupUi(self, Dialog):
        Dialog.resize(400, 300)
        self.verticalLayout = QtWidgets.QVBoxLayout(Dialog)
        self.tableWidget = QtWidgets.QTableWidget(Dialog)
        self.tableWidget.setColumnCount(6)
        self.tableWidget.setRowCount(0)
        item = QtWidgets.QTableWidgetItem()
        item.setText("1")
        self.tableWidget.setHorizontalHeaderItem(0, item)
        item = QtWidgets.QTableWidgetItem()
        item.setText("2")
        self.tableWidget.setHorizontalHeaderItem(1, item)
        item = QtWidgets.QTableWidgetItem()
        item.setText("3")
        self.tableWidget.setHorizontalHeaderItem(2, item)
        item = QtWidgets.QTableWidgetItem()
        item.setText("4")
        self.tableWidget.setHorizontalHeaderItem(3, item)
        item = QtWidgets.QTableWidgetItem()
        item.setText("5")
        self.tableWidget.setHorizontalHeaderItem(4, item)
        item = QtWidgets.QTableWidgetItem()
        item.setText("6")
        self.tableWidget.setHorizontalHeaderItem(5, item)
        self.verticalLayout.addWidget(self.tableWidget)

        QtCore.QMetaObject.connectSlotsByName(Dialog)

文件：run_me.py

from PyQt5 import QtWidgets,QtCore,QtGui
from table import Ui_Dialog
import sys

class Run_me:
    
    def __init__(self):
        self.app = QtWidgets.QApplication(sys.argv)
        self.Dialog = QtWidgets.QDialog()
        self.ui = Ui_Dialog()
        self.ui.setupUi(self.Dialog)
        self.Dialog.show()
        
        self.columns_min_width = []
        self.ui.tableWidget.resizeColumnsToContents()
        self.find_table_column_min_width()

        horizontal_header = self.ui.tableWidget.horizontalHeader()
        self.ui.tableWidget.setHorizontalHeader(CustomHeader(self.ui.tableWidget,self.columns_min_width))
        self.ui.tableWidget.updateGeometries()
        for column_index in range(0,len(self.columns_min_width)):
            header_item_text = self.ui.tableWidget.horizontalHeaderItem(column_index).text()
            print(header_item_text)
        
        sys.exit(self.app.exec_())

    def find_table_column_min_width(self):
        total_columns = self.ui.tableWidget.columnCount()
        self.columns_min_width = []
        for column_index in range(0,total_columns):
            column_width = self.ui.tableWidget.columnWidth(column_index)
            print(column_width)
            self.columns_min_width.append(column_width)

class CustomHeader(QtWidgets.QHeaderView):
    def __init__(self,table,columns_min_width):
        self.columns_min_width = columns_min_width
        self.total_columns = len(self.columns_min_width)
        self.header_labels = []
        for column_index in range(0,self.total_columns):
            column_text = table.horizontalHeaderItem(column_index).text()
            self.header_labels.append(column_text)
        super().__init__(QtCore.Qt.Horizontal,table)
        self.table = self.parentWidget()
        for column_index in range(0,self.total_columns):
            header_item = self.parentWidget().horizontalHeaderItem(column_index)
            header_item.setText(self.header_labels[column_index])
        self.track_move = False
        self.updateGeometries()
        
    def mousePressEvent(self,event):
        self.track_move = True
        QtWidgets.QHeaderView.mousePressEvent(self, event)
        print("Pressed")
    
    def mouseMoveEvent(self,event):
        if self.track_move:
            print("Moved while pressed")
            for column_index in range(0,self.total_columns):
                column_width = self.parentWidget().columnWidth(column_index)
                if column_width < self.columns_min_width[column_index]:
                    event.ignore()
                    return None
            QtWidgets.QHeaderView.mouseMoveEvent(self, event)
        else:
            QtWidgets.QHeaderView.mouseMoveEvent(self, event)
        
    def mouseReleaseEvent(self,event):
        self.track_move = False
        QtWidgets.QHeaderView.mouseReleaseEvent(self, event)
        print("Released")

        
if __name__ == "__main__":
    program = Run_me()

核心问题 #

表头不可见的主要原因是替换自定义表头时，未继承原表头的关键显示配置，且CustomHeader初始化逻辑存在冗余操作，导致表头布局和显示状态异常。

具体修复步骤 #

1. 保留原表头基础配置：替换表头前，可获取原表头的resize模式等属性，或直接在自定义表头中设置默认显示属性（如setSectionResizeMode）。
2. 简化CustomHeader初始化：无需重复获取和设置表头文本，原TableWidget已包含这些内容；移除不必要的updateGeometries调用，交由Qt自动处理布局。
3. 优化列宽约束逻辑：鼠标拖动时仅校验当前操作的列，而非遍历所有列，避免逻辑错误。

修改后的run_me.py代码 #

from PyQt5 import QtWidgets,QtCore,QtGui
from table import Ui_Dialog
import sys

class Run_me:
    
    def __init__(self):
        self.app = QtWidgets.QApplication(sys.argv)
        self.Dialog = QtWidgets.QDialog()
        self.ui = Ui_Dialog()
        self.ui.setupUi(self.Dialog)
        
        self.columns_min_width = []
        self.ui.tableWidget.resizeColumnsToContents()
        self.find_table_column_min_width()

        # 创建并设置自定义表头
        custom_header = CustomHeader(self.ui.tableWidget, self.columns_min_width)
        # 设置表头可交互调整宽度
        custom_header.setSectionResizeMode(QtWidgets.QHeaderView.Interactive)
        self.ui.tableWidget.setHorizontalHeader(custom_header)
        
        self.Dialog.show()
        sys.exit(self.app.exec_())

    def find_table_column_min_width(self):
        total_columns = self.ui.tableWidget.columnCount()
        self.columns_min_width = []
        for column_index in range(total_columns):
            column_width = self.ui.tableWidget.columnWidth(column_index)
            print(column_width)
            self.columns_min_width.append(column_width)

class CustomHeader(QtWidgets.QHeaderView):
    def __init__(self, table, columns_min_width):
        super().__init__(QtCore.Qt.Horizontal, table)
        self.columns_min_width = columns_min_width
        self.table = table
        self.track_move = False
        self.current_section = -1
        # 显式设置表头可见
        self.setVisible(True)
        
    def mousePressEvent(self, event):
        self.track_move = True
        # 获取当前点击的列索引
        self.current_section = self.logicalIndexAt(event.pos())
        super().mousePressEvent(event)
    
    def mouseMoveEvent(self, event):
        if self.track_move and self.current_section != -1:
            # 计算拖动后的预期宽度
            section_pos = self.sectionPosition(self.current_section)
            new_width = event.pos().x() - section_pos
            if new_width < self.columns_min_width[self.current_section]:
                # 禁止缩小到最小宽度以下
                return
        super().mouseMoveEvent(event)
        
    def mouseReleaseEvent(self, event):
        self.track_move = False
        self.current_section = -1
        super().mouseReleaseEvent(event)

if __name__ == "__main__":
    program = Run_me()

修复说明 #

• 移除了CustomHeader中冗余的表头文本处理逻辑，直接复用原TableWidget的表头项。
• 显式设置setVisible(True)确保表头可见。
• 优化鼠标拖动逻辑，仅校验当前操作列的宽度，避免误拦截正常操作。
• 调整Dialog.show()位置，确保所有UI配置完成后再显示窗口。

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