【Qt6.3 基础教程 14】实现树形数据结构：QTreeView与自定义模型

---

前言

在许多类型的应用程序中，有必要以树形结构呈现数据，以便用户可以方便地浏览和管理层次化的信息。Qt框架通过QTreeView组件和强大的自定义模型提供了这项功能。本篇博客将引导你了解如何在Qt中使用QTreeView以及如何创建一个自定义模型来管理和展示复杂的层次数据。

QTreeView简介

QTreeView是Qt中的一个小部件，它可以显示由父节点和子节点组成的数据。与QTableView和QListView相比，QTreeView可以展示嵌套的数据列表，这些数据通常以树状结构存储。

树形视图的主要特性

• 可折叠的节点：用户可以展开或折叠树状结构中的节点。
• 自定义列：每个节点可以有多个列来显示不同的属性。
• 数据定制：支持通过委托自定义节点的显示方式。

创建自定义模型

虽然Qt提供了QStandardItemModel作为处理树形结构的通用模型，但有时你可能需要根据特定的需求来创建自定义模型。自定义模型通常继承自QAbstractItemModel。

自定义模型的关键方法

实现自定义模型时，需要重写以下几个方法：

• rowCount(const QModelIndex &parent)：返回给定父项下的子项数量。
• columnCount(const QModelIndex &parent)：返回树的列数。
• data(const QModelIndex &index, int role)：根据索引和角色返回数据。
• index(int row, int column, const QModelIndex &parent)：创建一个新的模型索引。
• parent(const QModelIndex &index)：返回指定索引项的父项。

示例：自定义模型的骨架

class TreeModel : public QAbstractItemModel {
    Q_OBJECT

public:
    explicit TreeModel(QObject *parent = nullptr);
    ~TreeModel();

    // 必须实现的方法
    QModelIndex index(int row, int column, const QModelIndex &parent = QModelIndex()) const override;
    QModelIndex parent(const QModelIndex &index) const override;
    int rowCount(const QModelIndex &parent = QModelIndex()) const override;
    int columnCount(const QModelIndex &parent = QModelIndex()) const override;
    QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override;

    // ... 其他方法和私有成员 ...
};

在上面的代码中，我们定义了一个名为TreeModel的新模型类，它重写了所有必要的方法。

在QTreeView中使用自定义模型

一旦创建了自定义模型，你可以将其实例化并将其设置为QTreeView的模型。

示例：设置模型

// 实例化自定义模型
TreeModel *model = new TreeModel(this);

// 创建QTreeView
QTreeView *treeView = new QTreeView(this);
treeView->setModel(model);

// 展示树形视图
treeView->show();

通过上述步骤，我们将自定义模型与QTreeView关联起来，创建了一个功能齐全的树形视图。

总结

QTreeView和自定义模型是Qt中管理和展示层次化数据的强大工具。通过理解如何使用QTreeView和创建自定义模型，你可以构建复杂且交互性强的用户界面。这篇博客的目的是为你提供一个入门指南，帮助你开始在Qt中使用树形视图和自定义模型。随着对Qt的深入学习，你将能够创建更加复杂和高度定制的模型，以满足你应用程序的具体需求。