QTreeView按需取数优化：列宽适配加载与选中项全数据刷新

核心解决方案：选中条目触发完整数据刷新 #

你已经通过sectionResized信号实现了列宽驱动的截断显示，要实现选中时展示完整数据，核心是监听选中状态变化并触发对应行/单元格的UI刷新：

• 监听QTreeView的selectionModel()的currentChanged信号，该信号在选中项切换时触发，传递旧选中索引和新选中索引。
• 在信号槽中，通过模型的dataChanged信号通知视图刷新这两个索引的显示（旧选中项切回截断状态，新选中项切换为完整状态）。
• 在模型的data()方法中，判断当前索引是否为选中状态：如果是，返回完整数据；否则返回根据列宽截断后的带省略号内容。

多列适配方案 #

如果扩展到多列场景，可按以下逻辑处理：

• 为每一列维护独立的截断宽度阈值（基于列宽计算），保存在模型或视图中。
• 若为整行选中模式，该行所有列切换为完整数据显示；若支持单元格级选中，单独判断单元格索引是否被选中。
• 列宽变化时，仅更新对应列的截断阈值，避免全局刷新影响性能。

Python 代码示例（PyQt5） #

from PyQt5.QtWidgets import QApplication, QTreeView, QAbstractItemModel, QModelIndex
from PyQt5.QtCore import Qt, QVariant

class LongDataTreeModel(QAbstractItemModel):
    def __init__(self, full_data, parent=None):
        super().__init__(parent)
        self.full_data = full_data  # 格式：[[row0_col0, row0_col1], ...]
        self.current_selected = QModelIndex()  # 记录当前选中索引
        self.col_max_width = {}  # 存储各列可显示宽度（用于截断）

    def index(self, row, column, parent=QModelIndex()):
        if parent.isValid():
            return QModelIndex()
        return self.createIndex(row, column, None)

    def parent(self, index):
        return QModelIndex()

    def rowCount(self, parent=QModelIndex()):
        return len(self.full_data) if not parent.isValid() else 0

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

    def data(self, index, role=Qt.DisplayRole):
        if not index.isValid() or role != Qt.DisplayRole:
            return QVariant()

        full_text = self.full_data[index.row()][index.column()]
        # 选中状态返回完整内容
        if index == self.current_selected:
            return full_text

        # 非选中状态按列宽截断
        col = index.column()
        if col not in self.col_max_width:
            return full_text

        font_metrics = QApplication.fontMetrics()
        truncated_text = font_metrics.elidedText(full_text, Qt.ElideRight, self.col_max_width[col])
        return truncated_text

    def update_col_width(self, column, width):
        self.col_max_width[column] = width - 10  # 预留少量余量
        # 刷新该列所有行
        top_left = self.index(0, column)
        bottom_right = self.index(self.rowCount()-1, column)
        self.dataChanged.emit(top_left, bottom_right, [Qt.DisplayRole])

    def update_selected(self, new_index):
        # 刷新旧选中项
        if self.current_selected.isValid():
            self.dataChanged.emit(self.current_selected, self.current_selected, [Qt.DisplayRole])
        # 更新并刷新新选中项
        self.current_selected = new_index
        if new_index.isValid():
            self.dataChanged.emit(new_index, new_index, [Qt.DisplayRole])

if __name__ == "__main__":
    app = QApplication([])
    # 模拟超长数据
    full_data = [
        ["Lorem ipsum dolor sit amet, consectetur adipiscing elit." * 20, "Short text col1"],
        ["Another extremely long string that exceeds 64KB..." * 50, "Short text col2"],
    ]
    view = QTreeView()
    model = LongDataTreeModel(full_data)
    view.setModel(model)

    # 绑定列宽变化信号
    view.header().sectionResized.connect(lambda idx, _, new_w: model.update_col_width(idx, new_w))
    # 绑定选中变化信号
    view.selectionModel().currentChanged.connect(lambda new_idx, _: model.update_selected(new_idx))

    view.show()
    app.exec_()

C++ 代码示例 #

#include <QApplication>
#include <QTreeView>
#include <QAbstractItemModel>
#include <QFontMetrics>

class LongDataTreeModel : public QAbstractItemModel
{
    Q_OBJECT
public:
    explicit LongDataTreeModel(const QVector<QVector<QString>>& fullData, QObject* parent = nullptr)
        : QAbstractItemModel(parent), m_fullData(fullData)
    {}

    QModelIndex index(int row, int column, const QModelIndex& parent = QModelIndex()) const override
    {
        if (parent.isValid()) return QModelIndex();
        return createIndex(row, column, nullptr);
    }

    QModelIndex parent(const QModelIndex&) const override { return QModelIndex(); }
    int rowCount(const QModelIndex& parent = QModelIndex()) const override
    { return parent.isValid() ? 0 : m_fullData.size(); }
    int columnCount(const QModelIndex& parent = QModelIndex()) const override
    { return parent.isValid() ? 0 : (m_fullData.isEmpty() ? 0 : m_fullData.first().size()); }

    QVariant data(const QModelIndex& index, int role = Qt::DisplayRole) const override
    {
        if (!index.isValid() || role != Qt::DisplayRole) return QVariant();

        const QString& fullText = m_fullData[index.row()][index.column()];
        // 选中状态返回完整文本
        if (index == m_currentSelected) return fullText;

        // 非选中状态截断显示
        auto it = m_colMaxWidth.find(index.column());
        if (it == m_colMaxWidth.end()) return fullText;

        QFontMetrics metrics(QApplication::font());
        return metrics.elidedText(fullText, Qt::ElideRight, it->second);
    }

    void updateColWidth(int column, int width)
    {
        m_colMaxWidth[column] = width - 10;
        emit dataChanged(index(0, column), index(rowCount()-1, column), {Qt::DisplayRole});
    }

    void updateSelected(const QModelIndex& newIndex)
    {
        if (m_currentSelected.isValid())
            emit dataChanged(m_currentSelected, m_currentSelected, {Qt::DisplayRole});
        m_currentSelected = newIndex;
        if (newIndex.isValid())
            emit dataChanged(newIndex, newIndex, {Qt::DisplayRole});
    }

private:
    QVector<QVector<QString>> m_fullData;
    QModelIndex m_currentSelected;
    QHash<int, int> m_colMaxWidth;
};

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    // 模拟超长数据
    QVector<QVector<QString>> fullData = {
        {QString("Lorem ipsum dolor sit amet, consectetur adipiscing elit. ").repeated(20), "Short text col1"},
        {QString("Another extremely long string that exceeds 64KB... ").repeated(50), "Short text col2"}
    };

    QTreeView view;
    LongDataTreeModel* model = new LongDataTreeModel(fullData);
    view.setModel(model);

    // 绑定列宽变化信号
    QObject::connect(view.header(), &QHeaderView::sectionResized, [model](int idx, int, int newW) {
        model->updateColWidth(idx, newW);
    });
    // 绑定选中变化信号
    QObject::connect(view.selectionModel(), &QItemSelectionModel::currentChanged, [model](const QModelIndex& newIdx, const QModelIndex&) {
        model->updateSelected(newIdx);
    });

    view.show();
    return a.exec();
}

#include "main.moc"

关键注意点 #

• 文本截断使用QFontMetrics::elidedText，自动适配字体宽度添加省略号，比手动截断更准确。
• 刷新UI时缩小范围：列宽变化仅刷新对应列，选中变化仅刷新旧/新选中项，避免全局刷新拖慢性能。
• 若数据量极大（上万行），可额外优化：仅刷新可见区域行，或使用QAbstractItemView::setBatchSize分批加载。

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