【Qt笔记】QTreeView控件详解

冷眼看人间恩怨

已于 2024-08-30 17:24:31 修改

阅读量2k

点赞数 27

分类专栏： Qt 文章标签： qt 笔记开发语言 QTreeView

于 2024-08-30 10:53:40 首次发布

本文链接：https://blog.csdn.net/qq_52924376/article/details/141702389

版权

Qt 专栏收录该内容

29 篇文章 5 订阅

订阅专栏

1. 继承QAbstractItemModel

引言

QTreeView是Qt框架中一个非常重要的控件，用于展示和操作层次化或树形结构的数据。它基于模型/视图架构，通过与数据模型的结合，实现了数据的灵活展示和用户交互。本文将详细解析QTreeView的各个方面，包括基本用法、自定义模型、视图和委托的创建、过滤与排序、拖放支持等，并附带代码示例以帮助理解。

一、QTreeView的基本用法

1. 创建QTreeView

首先，你需要在Qt项目中包含QTreeView的头文件，并在适当的位置创建QTreeView的实例。

#include <QTreeView>  
  
// ...  
  
QTreeView *treeView = new QTreeView(parentWidget);

其中，parentWidget是QTreeView的父窗口或控件，如果不需要父对象，可以传入nullptr。

2. 设置数据模型

QTreeView本身不存储数据，而是通过与数据模型（如QStandardItemModel、QFileSystemModel等）的结合来展示数据。你需要先创建一个数据模型，并将其设置给QTreeView。

#include <QStandardItemModel>  
  
// ...  
  
QStandardItemModel *model = new QStandardItemModel();  
// 假设我们添加一些数据  
QStandardItem *rootNode = model->invisibleRootItem();  
QStandardItem *parentItem = new QStandardItem("Parent");  
QStandardItem *childItem = new QStandardItem("Child");  
  
parentItem->appendRow(childItem);  
rootNode->appendRow(parentItem);  
  
treeView->setModel(model);

3. 展开和折叠节点

QTreeView提供了多种方法来展开和折叠节点。

// 展开第一个父节点  
QModelIndex parentIndex = model->index(0, 0);  
treeView->expand(parentIndex);  
  
// 展开所有节点  
treeView->expandAll();  
  
// 折叠所有节点  
treeView->collapseAll();

4. 处理用户交互

QTreeView提供了多种信号，如clicked(), doubleClicked(), selectionChanged()等，用于处理用户交互。

connect(treeView, &QTreeView::clicked, this, &MyClass::onItemClicked);  
  
// ...  
  
void MyClass::onItemClicked(const QModelIndex &index) {  
    // 处理单击事件  
    qDebug() << "Clicked item:" << index.data().toString();  
}

二、自定义数据模型

当内置的数据模型（如QStandardItemModel）不满足需求时，你可以创建自定义的数据模型。

1. 继承QAbstractItemModel

自定义模型需要继承自QAbstractItemModel或其子类，并实现必要的方法和信号。

#include <QAbstractItemModel>  
  
class MyModel : public QAbstractItemModel {  
    Q_OBJECT  
  
public:  
    // 实现必要的接口方法，如index(), parent(), rowCount(), columnCount(), data(), setData()等  
  
    // ...  
};

2. 实现必要的方法

在自定义模型中，你需要实现如index(), parent(), rowCount(), columnCount(), data(), setData()等方法来提供对数据的访问和操作。

3. 使用自定义模型

创建并填充自定义模型后，可以将其设置给QTreeView来显示数据。

MyModel *myModel = new MyModel();  
// 假设已经填充了数据  
treeView->setModel(myModel);

三、自定义视图和委托

1. 自定义视图

自定义视图通常通过继承QTreeView类并重写特定方法来实现。但大多数情况下，QTreeView的默认行为已经足够，你可能只需要通过委托来自定义节点的外观和交互。

2. 自定义委托

自定义委托通过继承QAbstractItemDelegate或更具体的QStyledItemDelegate类来实现。在委托中，你可以重写paint()和editorEvent()等方法来自定义节点的绘制和编辑行为。

#include <QStyledItemDelegate>  
#include <QPainter>  
  
class MyDelegate : public QStyledItemDelegate {  
public:  
    using QStyledItemDelegate::QStyledItemDelegate;  
  
    void paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const override {  
        // 自定义绘制逻辑  
        // ...  
    }  
  
    // 如果需要编辑功能，也需要重写editorEvent()方法  
};  
  
// ...  
  
treeView->setItemDelegate(new MyDelegate(treeView));

四、过滤与排序

1. 排序

QTreeView支持通过QSortFilterProxyModel对数据进行排序。

#include <QSortFilterProxyModel>  
  
// ...  
  
QSortFilterProxyModel *proxyModel = new QSortFilterProxyModel();  
proxyModel->setSourceModel(model);  
proxyModel->sort(0); // 根据第一列排序  
  
treeView->setModel(proxyModel);

2. 过滤

QSortFilterProxyModel同样支持过滤功能，通过重写其filterAcceptsRow()方法或设置filterRegExp、filterKeyColumn等属性来实现。

// 假设我们只想显示包含"特定文本"的行  
proxyModel->setFilterRegExp(QRegExp("特定文本", Qt::CaseInsensitive));

五、拖放支持

QTreeView支持拖放操作，允许用户通过拖放来重新组织树形结构中的数据。

1. 启用拖放

首先，需要在QTreeView上启用拖放功能。

treeView->setDragEnabled(true);  
treeView->setAcceptDrops(true);  
treeView->setDropIndicatorShown(true);

2. 处理拖放事件

然后，你需要在自定义模型或视图中重写拖放事件处理函数（如mimeTypes(), mimeData(), dropMimeData()等），以处理拖放操作。

六、应用场景示例

文件系统浏览器

使用QTreeView和QFileSystemModel可以方便地创建一个文件系统浏览器。

#include <QTreeView>  
#include <QFileSystemModel>  
  
// ...  
  
QTreeView *treeView = new QTreeView(parentWidget);  
QFileSystemModel *fileSystemModel = new QFileSystemModel();  
fileSystemModel->setRootPath(QDir::rootPath());  
  
treeView->setModel(fileSystemModel);  
treeView->setRootIndex(fileSystemModel->index(QDir::homePath()));