PySide6中QTableView开启排序后如何实现点表头文本选列、点箭头排序

问题原因 #

开启QTableView.setSortingEnabled(True)后，水平表头的sectionClicked信号会被默认绑定到内置排序槽函数，点击整个表头区域都会触发排序，原生的列选中逻辑被覆盖，所以无法实现点击不同区域触发不同交互的需求。

实现步骤 #

我们需要通过自定义水平表头类，重写点击事件判断点击位置，分别触发排序和列选中逻辑：

1. 自定义QHeaderView子类 #

重写mousePressEvent方法，识别点击位置属于排序箭头区域还是文本区域：

from PySide6.QtWidgets import QHeaderView, QStyleOptionHeader, QStyle
from PySide6.QtCore import Qt

class CustomHorizontalHeader(QHeaderView):
    def __init__(self, parent=None):
        super().__init__(Qt.Horizontal, parent)
        # 保留表头可点击、排序图标显示的特性
        self.setSectionsClickable(True)
        self.setSortIndicatorShown(True)

    def mousePressEvent(self, event):
        if event.button() == Qt.LeftButton:
            # 获取点击位置对应的列索引
            click_col = self.logicalIndexAt(event.pos())
            if click_col < 0:
                return super().mousePressEvent(event)
            
            # 计算当前列排序箭头的绘制区域
            opt = QStyleOptionHeader()
            self.initStyleOption(opt, click_col)
            header_style = self.style()
            sort_indicator_rect = header_style.subElementRect(QStyle.SE_HeaderSortIndicator, opt, self)
            
            if sort_indicator_rect.contains(event.pos()):
                # 点击排序箭头，切换排序顺序并执行排序
                current_order = self.sortIndicatorOrder()
                new_order = Qt.AscendingOrder if current_order == Qt.DescendingOrder else Qt.DescendingOrder
                self.setSortIndicator(click_col, new_order)
                # 触发绑定的QSortFilterProxyModel排序
                self.parent().model().sort(click_col, new_order)
            else:
                # 点击文本区域，选中对应列
                self.parent().selectColumn(click_col)
            return
        # 其他按键事件走原生逻辑
        super().mousePressEvent(event)

2. 绑定自定义表头到QTableView #

初始化组件时替换原生水平表头，注意不要调用原生的setSortingEnabled(True)，避免覆盖自定义逻辑：

# 初始化表格和数据源
table_view = QTableView()
proxy_model = QSortFilterProxyModel()
proxy_model.setSourceModel(your_original_data_model) # 替换为你自己的源模型
table_view.setModel(proxy_model)

# 替换原生表头为自定义表头
custom_header = CustomHorizontalHeader(table_view)
table_view.setHorizontalHeader(custom_header)

注意事项 #

• 如果需要支持列多选，可以在点击文本区域的逻辑中添加对Ctrl/Shift修饰键的判断，调用对应的选中接口即可
• 如果你自定义了表头的QSS样式，需要确认排序箭头的绘制区域是否和系统默认一致，如有偏移可以调整区域判断逻辑兼容

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