QTreeView设置Stretch模式的列最小宽度过大问题求助

问题描述 #

配置QTreeView时，将前两列设为ResizeToContents（自适应内容），最后一列设为ResizeMode.Stretch（拉伸），但最后一列"Balance"的最小宽度远超出需求，窗口收缩时无法正常缩小。尝试调用QTreeView.header().setMinimumWidth(0)无效，运行环境为Python 3.11.2、PyQt 6.4.2。

问题根源 #

QTreeView的表头（QHeaderView）在Stretch模式下，默认会将列的最小宽度计算为表头文本推荐宽度+单元格内容最小宽度+默认内边距。即使该列内容仅为"0"，但由于设置了AlignRight对齐方式，加上Qt默认的布局冗余空间，最终计算出的最小宽度会远大于表头文本本身的宽度。另外，header.setMinimumWidth(0)是设置整个表头的最小宽度，而非单独列的最小宽度，因此无法解决问题。

解决方案 #

手动为最后一列设置自定义最小宽度，覆盖默认计算值。可以直接指定固定值，或通过QFontMetrics精准计算表头文本的实际宽度，再添加少量内边距。

修改后的完整代码 #

import sys
from typing import Any
from PyQt6.QtGui import QFontMetrics

from PyQt6 import QtWidgets
from PyQt6.QtCore import QAbstractItemModel, QModelIndex, Qt
from PyQt6.QtWidgets import QApplication, QHeaderView, QTreeView, QWidget


class Form(QWidget):
    def __init__(self, parent: QWidget | None = None) -> None:
        super().__init__(parent=parent)
        self.resize(323, 454)

        self.horizontalLayout = QtWidgets.QHBoxLayout(self)
        self.horizontalLayout.setObjectName("horizontalLayout")
        self.verticalLayout = QtWidgets.QVBoxLayout()
        self.verticalLayout.setObjectName("verticalLayout")
        self.horizontalLayout.addLayout(self.verticalLayout)

        self.treeView = QTreeView(self)
        self.verticalLayout.addWidget(self.treeView)
        self.treeView.setModel(CategoryTreeModel(self.treeView))

        header = self.treeView.header()
        header.setSectionResizeMode(0, QHeaderView.ResizeMode.ResizeToContents)
        header.setSectionResizeMode(1, QHeaderView.ResizeMode.ResizeToContents)
        header.setSectionResizeMode(2, QHeaderView.ResizeMode.Stretch)
        
        # 方式1：直接设置固定最小宽度
        # header.setSectionMinimumWidth(2, 60)
        
        # 方式2：精准计算表头文本宽度+内边距
        font = header.font()
        metrics = QFontMetrics(font)
        text_width = metrics.horizontalAdvance("Balance") + 10  # 加10px内边距
        header.setSectionMinimumWidth(2, text_width)


class CategoryTreeModel(QAbstractItemModel):
    COLUMN_HEADERS = {
        0: "Name",
        1: "Transactions",
        2: "Balance",
    }

    def __init__(
        self,
        tree_view: QTreeView,
    ) -> None:
        super().__init__()
        self._tree_view = tree_view

    def rowCount(self, index: QModelIndex = ...) -> int:
        return 5

    def columnCount(self, index: QModelIndex = ...) -> int:  # noqa: U100
        return 3

    def index(self, row: int, column: int, _parent: QModelIndex = ...) -> QModelIndex:
        return QAbstractItemModel.createIndex(self, row, column, "item")

    def parent(self, index: QModelIndex = ...) -> QModelIndex:
        return QModelIndex()

    def data(self, index: QModelIndex, role: Qt.ItemDataRole = ...) -> Any:
        if not index.isValid():
            return None
        column = index.column()
        if role == Qt.ItemDataRole.DisplayRole:
            if column == 0:
                return "some very long name"
            if column == 1:
                return "0"
            if column == 2:
                return "0"
        return None

    def headerData(
        self, section: int, orientation: Qt.Orientation, role: Qt.ItemDataRole = ...
    ) -> str | int | None:
        if role == Qt.ItemDataRole.TextAlignmentRole:
            if section == 2:
                return Qt.AlignmentFlag.AlignRight | Qt.AlignmentFlag.AlignVCenter
        if role == Qt.ItemDataRole.DisplayRole:
            if orientation == Qt.Orientation.Horizontal:
                return self.COLUMN_HEADERS[section]
            return str(section)
        return None


app = QApplication(sys.argv)
form = Form()
form.show()
app.exec()

效果说明 #

设置自定义最小宽度后，窗口收缩时：

1. 前两列保持ResizeToContents的自适应宽度，不会被压缩；
2. 最后一列会在设置的最小宽度范围内灵活拉伸/收缩，符合预期布局需求。

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