PyQt5 QTableView垂直表头指定行背景颜色修改问题

可以通过headerData结合Qt.BackgroundRole实现需求，但需要处理系统样式的覆盖问题，以下是可复现的完整代码及关键说明：

可复现代码 #

import sys
from PyQt5.QtWidgets import (QApplication, QMainWindow, QTableView, QPushButton, 
                             QVBoxLayout, QWidget)
from PyQt5.QtCore import Qt, QAbstractTableModel, QVariant
from PyQt5.QtGui import QBrush, QColor

class CustomTableModel(QAbstractTableModel):
    def __init__(self, data):
        super().__init__()
        self._data = data
        self.highlight_row = -1  # 标记要高亮的垂直表头行号（从0开始）

    def rowCount(self, parent=None):
        return len(self._data)

    def columnCount(self, parent=None):
        return len(self._data[0]) if self._data else 0

    def data(self, index, role=Qt.DisplayRole):
        if not index.isValid():
            return QVariant()
        if role == Qt.DisplayRole:
            return self._data[index.row()][index.column()]
        return QVariant()

    def headerData(self, section, orientation, role=Qt.DisplayRole):
        # 处理垂直表头
        if orientation == Qt.Vertical:
            if role == Qt.DisplayRole:
                return f"行{section+1}"
            # 设置文字颜色
            elif role == Qt.TextColorRole and section == self.highlight_row:
                return QBrush(QColor(Qt.red))
            # 设置背景颜色
            elif role == Qt.BackgroundRole and section == self.highlight_row:
                return QBrush(QColor(Qt.yellow))
        return super().headerData(section, orientation, role)

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("垂直表头样式测试")
        self.resize(600, 400)

        # 构造测试数据
        data = [
            [f"({i},{j})" for j in range(3)] for i in range(5)
        ]
        self.model = CustomTableModel(data)
        self.tableView = QTableView()
        self.tableView.setModel(self.model)

        # 解决系统样式覆盖背景色的关键：让表头section背景透明
        self.tableView.verticalHeader().setStyleSheet(
            "QHeaderView::section { background-color: transparent; }"
        )

        # 按钮触发高亮
        self.btn_highlight = QPushButton("高亮第二行垂直表头")
        self.btn_highlight.clicked.connect(self.highlight_target_row)

        layout = QVBoxLayout()
        layout.addWidget(self.tableView)
        layout.addWidget(self.btn_highlight)

        central_widget = QWidget()
        central_widget.setLayout(layout)
        self.setCentralWidget(central_widget)

    def highlight_target_row(self):
        self.model.highlight_row = 1  # 第二行对应索引1
        # 通知视图表头数据更新
        self.model.headerDataChanged.emit(Qt.Vertical, 1, 1)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    # 可选：切换到Fusion样式，减少系统样式干扰
    app.setStyle("Fusion")
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

关键说明 #

1. 返回正确的画笔对象：在headerData中处理Qt.BackgroundRole时，必须返回QBrush（而非单纯的QColor），否则无法正确应用背景色。
2. 解决系统样式覆盖：Windows原生样式会强制绘制表头背景，通过给垂直表头添加样式表QHeaderView::section { background-color: transparent; }，可以让我们通过BackgroundRole设置的颜色显示出来。
3. 通知视图更新：修改高亮行后，必须调用headerDataChanged信号，触发视图重新渲染表头。

如果切换Fusion样式后仍有问题，上述样式表设置是核心解决方案，它能绕过系统样式的背景绘制逻辑，让headerData返回的背景色生效。

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