QHeaderView行索引与行文本垂直偏移问题及索引起始值修改求助

一、解决行索引与内容的垂直偏移问题 #

偏移的核心原因是垂直表头（行索引）的文本对齐未与表格单元格保持一致，可通过以下任一方法修复：

方法1：在模型中统一设置表头对齐 #

修改PandasModel的headerData方法，为垂直表头添加垂直居中对齐规则：

def headerData(self, section: int, orientation: Qt.Orientation, role: Qt.ItemDataRole) -> any:
    """重写QAbstractTableModel中的方法

    返回dataframe的索引作为垂直表头数据，列名作为水平表头数据。
    """
    if role == Qt.ItemDataRole.DisplayRole:
        if orientation == Qt.Orientation.Horizontal:
            return str(self._dataframe.columns[section])

        if orientation == Qt.Orientation.Vertical:
            return str(self._dataframe.index[section])
    # 新增：设置表头文本对齐，与单元格保持垂直居中
    if role == Qt.ItemDataRole.TextAlignmentRole:
        if orientation == Qt.Orientation.Vertical:
            return Qt.AlignmentFlag.AlignRight | Qt.AlignmentFlag.AlignVCenter
        if orientation == Qt.Orientation.Horizontal:
            return Qt.AlignmentFlag.AlignLeft | Qt.AlignmentFlag.AlignVCenter
    return None

方法2：在表格初始化时设置垂直表头对齐 #

在creat_table函数中添加垂直表头的对齐配置：

def creat_table(qtable_view, data):
    qtable_view: QTableView
    qtable_view.setStyleSheet(STYLE_SHEET["table_view"])
    qtable_view.horizontalHeader().setStretchLastSection(True)
    qtable_view.setAlternatingRowColors(True)
    qtable_view.setSelectionBehavior(QTableView.SelectionBehavior.SelectRows)

    # 新增：设置垂直表头文本垂直居中+右对齐
    qtable_view.verticalHeader().setDefaultAlignment(Qt.AlignmentFlag.AlignRight | Qt.AlignmentFlag.AlignVCenter)

    model = PandasModel(data)
    qtable_view.setModel(model)

方法3：同步表头与表格行高 #

如果手动设置了表格行高，需同步垂直表头的行高：

def creat_table(qtable_view, data):
    # ... 原有代码 ...
    # 设置表格行高（示例值）
    qtable_view.setRowHeight(0, 30)
    # 同步垂直表头行高
    qtable_view.verticalHeader().setDefaultSectionSize(30)
    # ... 原有代码 ...

二、让行索引从1开始而非0 #

只需修改PandasModel的headerData方法，强制垂直表头返回section + 1即可：

def headerData(self, section: int, orientation: Qt.Orientation, role: Qt.ItemDataRole) -> any:
    """重写QAbstractTableModel中的方法

    返回dataframe的索引作为垂直表头数据，列名作为水平表头数据。
    """
    if role == Qt.ItemDataRole.DisplayRole:
        if orientation == Qt.Orientation.Horizontal:
            return str(self._dataframe.columns[section])

        if orientation == Qt.Orientation.Vertical:
            # 替换原index，强制显示从1开始的序号
            return str(section + 1)
    # 可选：添加对齐设置（同方法1）
    if role == Qt.ItemDataRole.TextAlignmentRole:
        if orientation == Qt.Orientation.Vertical:
            return Qt.AlignmentFlag.AlignRight | Qt.AlignmentFlag.AlignVCenter
        if orientation == Qt.Orientation.Horizontal:
            return Qt.AlignmentFlag.AlignLeft | Qt.AlignmentFlag.AlignVCenter
    return None

如果需要同时修改dataframe本身的索引（而非仅显示），可在创建模型前调整：

# 重置索引并从1开始
data = data.reset_index(drop=True)
data.index = data.index + 1

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