PyQt5 QTableWidget表头右侧排序指示器显示不全如何解决

问题原因 #

QHeaderView默认仅在表头文字的左侧/顶部为排序指示器预留显示空间。直接通过样式表把指示器挪到右侧时，表头分区未在右侧预留对应内边距，会导致指示器被控件边界裁切；加上默认指示器尺寸本身偏小，单独加偏移参数无法解决遮挡、显示错位问题。

修复方法 #

需要在样式表中同时配置表头分区内边距、升降序两个状态指示器的位置与尺寸，三个核心配置项缺一不可：

• 为表头分区（section）设置足够的右侧内边距，给指示器预留显示空间，避免被裁切
• 同时配置升序（up-arrow）、降序（down-arrow）两个指示器的定位基准、对齐位置、边距
• 自定义指示器宽高，解决默认箭头尺寸过小的问题

正确样式表示例 #

table.horizontalHeader().setStyleSheet("""
QHeaderView::section {
    padding-right: 20px;
}
QHeaderView::up-arrow, QHeaderView::down-arrow {
    subcontrol-origin: padding;
    subcontrol-position: center right;
    right: 4px;
    width: 10px;
    height: 10px;
}
""")

参数说明 #

• padding-right: 20px：给表头内容区右侧预留20px空间专门放置排序指示器，数值可根据实际需要的箭头大小调整
• subcontrol-origin: padding：指定指示器的位置计算基准为分区的内边距区域，避免偏移计算错位
• right: 4px：设置指示器距离分区右边界的距离，防止箭头贴边
• width/height：自定义指示器尺寸，解决默认箭头过小看不清的问题

修改后完整可运行代码 #

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QTableWidget, \
QTableWidgetItem, QVBoxLayout, QWidget
from PyQt5.QtCore import QSize


class Window(QMainWindow):
    def __init__(self):
        super().__init__()

        self.setMinimumSize(QSize(300, 300))

        table = QTableWidget()
        table.setSortingEnabled(True)
        table.horizontalHeader().setSortIndicatorShown(True)
        # 替换为正确的样式表配置
        table.horizontalHeader().setStyleSheet("""
        QHeaderView::section {
            padding-right: 20px;
        }
        QHeaderView::up-arrow, QHeaderView::down-arrow {
            subcontrol-origin: padding;
            subcontrol-position: center right;
            right: 4px;
            width: 10px;
            height: 10px;
        }
        """)
        table.setColumnCount(4)
        table.setRowCount(4)

        table.setHorizontalHeaderLabels(["Header-1", "Header-2", "Header-3", "Header-4"])

        for i in range(4):
            for j in range(4):
                table.setItem(i, j, QTableWidgetItem(str(i) + ", " + str(j)))

        self.layout = QVBoxLayout()
        self.layout.addWidget(table)
        widget = QWidget()
        widget.setLayout(self.layout)
        self.setCentralWidget(widget)
        self.show()

app = QApplication(sys.argv)
mw = Window()
app.exec() 

如果需要自定义箭头样式，可以额外给up-arrow、down-arrow添加image属性指定自定义图标资源，显示效果会更统一。

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