如何调用QtWidgets.QTableWidget.setHorizontalHeader()并保留默认行为？

默认情况下，QTableWidget的水平表头支持点击列标题选中整列：

from PyQt5 import QtWidgets

app = QtWidgets.QApplication([])

table = QtWidgets.QTableWidget(3, 3)
table.setHorizontalHeaderLabels(['1', '2', '3'])
table.show()
app.exec_()

但如果显式创建普通QHeaderView实例并替换默认表头，会丢失点击标题选中整列的默认行为：

from PyQt5 import QtWidgets, QtCore

class CustomTableWidget(QtWidgets.QTableWidget):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.setHorizontalHeader(QtWidgets.QHeaderView(QtCore.Qt.Horizontal))

app = QtWidgets.QApplication([])

table = CustomTableWidget(3, 3)
table.setHorizontalHeaderLabels(['1', '2', '3'])
table.show()
app.exec_()

原因分析 #

QTableWidget默认使用的水平表头是QTableWidgetHeader（QHeaderView的子类），该子类已经内置了与表格选择模型的绑定逻辑，实现了点击标题选中整列的功能。而普通QHeaderView实例没有这种绑定，因此替换后会丢失对应行为。

解决方案 #

方案1：保留默认表头（推荐，仅需修改属性时使用） #

如果不需要深度定制表头逻辑，直接获取默认表头修改属性即可，无需替换表头：

from PyQt5 import QtWidgets, QtCore

class CustomTableWidget(QtWidgets.QTableWidget):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 获取默认表头并修改
        header = self.horizontalHeader()
        # 示例：修改表头样式
        header.setStyleSheet("QHeaderView::section { background-color: #f0f0f0; }")
        # 其他自定义配置...

app = QtWidgets.QApplication([])

table = CustomTableWidget(3, 3)
table.setHorizontalHeaderLabels(['1', '2', '3'])
table.show()
app.exec_()

方案2：继承QTableWidgetHeader实现自定义表头 #

若需自定义表头行为，继承QTableWidgetHeader而非普通QHeaderView，这样可以保留原有的整列选中逻辑：

from PyQt5 import QtWidgets, QtCore

class CustomHeader(QtWidgets.QTableWidgetHeader):
    def __init__(self, orientation=QtCore.Qt.Horizontal, parent=None):
        super().__init__(orientation, parent)
        # 添加自定义逻辑，比如重写事件处理、修改样式等
        self.setStyleSheet("QHeaderView::section { background-color: #f0f0f0; }")

class CustomTableWidget(QtWidgets.QTableWidget):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 设置自定义表头
        self.setHorizontalHeader(CustomHeader(QtCore.Qt.Horizontal, self))
        # 确保表格允许整列选中（默认已开启，可根据需求调整）
        self.setSelectionBehavior(QtWidgets.QAbstractItemView.SelectColumns)

app = QtWidgets.QApplication([])

table = CustomTableWidget(3, 3)
table.setHorizontalHeaderLabels(['1', '2', '3'])
table.show()
app.exec_()

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