PyQt5中如何修改QTableView已筛选列的表头背景色

问题说明 #

在基于PyQt5实现的QTableView筛选功能中，当前通过CustomProxyModel的headerData()方法将已筛选列的表头字体设置为粗体。需要修改为仅给已筛选列的表头单独设置背景色，且不能通过全局样式表修改整个表头的背景色。

修改方案 #

核心是调整CustomProxyModel的headerData()方法，将原有的FontRole（字体角色）处理逻辑替换为BackgroundRole（背景色角色）的判断：

• 针对水平表头的背景色角色，判断当前列是否在已筛选列表filtered_columns中
• 若列处于筛选状态，返回自定义背景色；否则继承父类的默认背景设置（保留原样式表效果）

修改后的代码 #

调整后的CustomProxyModel类 #

class CustomProxyModel(QtCore.QSortFilterProxyModel):

    def __init__(self, parent=None):
        super().__init__(parent)
        self._filters = dict()
        self.filtered_columns = list()

    @property
    def filters(self):
        return self._filters

    def setFilter(self, expresion, column):
        if expresion:
            self.filters[column] = expresion
            # 避免重复添加同一列到筛选列表
            if column not in self.filtered_columns:
                self.filtered_columns.append(column)
        elif column in self.filters:
            del self.filters[column]
            self.filtered_columns.remove(column)
        self.invalidateFilter()
        # 发送信号通知表头更新样式
        self.headerDataChanged.emit(QtCore.Qt.Horizontal, 0, self.columnCount())

    def filterAcceptsRow(self, source_row, source_parent):
        for column, expresion in self.filters.items():
            text = self.sourceModel().index(source_row, column, source_parent).data()
            text = str(text)
            regex = QtCore.QRegExp(
                expresion, QtCore.Qt.CaseInsensitive, QtCore.QRegExp.RegExp
            )
            if regex.indexIn(text) == -1:
                return False
        return True

    def headerData(self, section, orientation, role):
        # 设置已筛选列的表头背景色
        if orientation == QtCore.Qt.Horizontal and role == QtCore.Qt.BackgroundRole:
            if section in self.filtered_columns:
                # 自定义筛选列的背景色，示例使用比原背景稍亮的蓝色
                return QtGui.QBrush(QtGui.QColor("#6A86C9"))
            # 未筛选列返回父类的背景设置（继承原样式表）
            return super().headerData(section, orientation, role)
        # 保留其他角色的默认处理（如文本、对齐方式等）
        return super().headerData(section, orientation, role)

关键优化点 #

1. 修复setFilter()方法中重复添加列的问题，避免筛选列表出现冗余项
2. 添加headerDataChanged信号，确保筛选状态变化时表头样式立即刷新
3. 自定义背景色可按需调整，示例颜色与原样式表的#4C6199形成视觉区分
4. 移除原字体加粗逻辑，若需保留可同时保留FontRole的处理分支

效果验证 #

修改后，点击表头设置筛选时，对应列的表头背景色会切换为自定义颜色；取消筛选后，自动恢复原样式表的背景色，其他未筛选列不受影响。

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