PyQt5 QHeaderView子类化：实现列宽限制与可见性控制

from PyQt5 import QtCore, QtGui, QtWidgets

class Ui_Dialog(object):
    def setupUi(self, Dialog):
        Dialog.setObjectName("Dialog")
        Dialog.resize(400, 300)
        self.verticalLayout = QtWidgets.QVBoxLayout(Dialog)
        self.verticalLayout.setObjectName("verticalLayout")
        self.tableWidget = QtWidgets.QTableWidget(Dialog)
        self.tableWidget.setObjectName("tableWidget")
        self.tableWidget.setColumnCount(6) # 设置6列
        self.tableWidget.setRowCount(0)   # 初始无行数据

        # 设置水平表头项文本
        header_texts = ["1", "2", "3", "4", "5", "6"]
        for i, text in enumerate(header_texts):
            item = QtWidgets.QTableWidgetItem()
            item.setText(text)
            self.tableWidget.setHorizontalHeaderItem(i, item)

        self.verticalLayout.addWidget(self.tableWidget)
        QtCore.QMetaObject.connectSlotsByName(Dialog)

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)

        # 调用父类构造函数，指定水平方向和父部件（QTableWidget）
        super().__init__(QtCore.Qt.Horizontal, table)

        # 获取QTableWidget实例，作为后续操作的父部件
        self.table = self.parentWidget() 

        # 重新设置表头文本，确保CustomHeader正确显示内容
        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.move_stopped = False # 标记是否因达到最小宽度而停止拖动

        # 关键一步：确保自定义Header可见
        # QHeaderView默认可能不可见，需要显式设置为True
        self.setVisible(True) 
        self.updateGeometries() # 更新几何布局

    def mousePressEvent(self, event):
        # 鼠标按下时，标记开始拖动
        self.track_move = True
        self.click_x = event.pos().x() # 记录鼠标按下时的X坐标
        QtWidgets.QHeaderView.mousePressEvent(self, event)

    def mouseMoveEvent(self, event):
        self.moved_x = event.pos().x() # 记录鼠标移动时的X坐标
        if self.track_move:
            self.move_cancelled = False # 标记本次移动是否被取消（达到最小宽度）
            for column_index in range(0, self.total_columns):
                column_width = self.parentWidget().columnWidth(column_index)

                if not self.move_cancelled: # 如果当前移动未被取消
                    if column_width <= self.columns_min_width[column_index]:
                        # 如果列宽小于或等于最小宽度
                        event.ignore() # 忽略当前事件，阻止默认的列宽调整
                        # 强制将列宽设置为最小宽度
                        self.table.setColumnWidth(column_index, self.columns_min_width[column_index])
                        self.move_cancelled = True # 标记移动被取消
                        self.index_cancelled = column_index # 记录是哪一列导致取消
                        # 将该列的调整模式设为Fixed，防止继续缩小
                        self.setSectionResizeMode(column_index, QtWidgets.QHeaderView.Fixed)
                    else:
                        # 如果列宽大于最小宽度，则允许交互式调整
                        self.setSectionResizeMode(column_index, QtWidgets.QHeaderView.Interactive)
                else:
                    # 如果移动已被取消（即某列已达到最小宽度）
                    # 检查是否已将鼠标拖离该列的最小宽度边界，以便重新启用交互式调整
                    if column_index == self.index_cancelled