C++ Qt开发：QFileSystemModel文件管理组件

原创

微软技术分享

发布于 2024-03-08 11:39:21

3360

发布于 2024-03-08 11:39:21

文章被收录于专栏：Qt Creator 编程技术实践Qt Creator 编程技术实践

Qt 是一个跨平台C++图形界面开发库，利用Qt可以快速开发跨平台窗体应用程序，在Qt中我们可以通过拖拽的方式将不同组件放到指定的位置，实现图形化开发极大的方便了开发效率，本章将重点介绍如何运用QFileSystemModel组件实现文件管理器功能。

QFileSystemModel是Qt框架中的一个关键类，用于在Qt应用程序中管理和展示文件系统的结构。该模型提供了一个方便的接口，使得开发者可以轻松地在应用程序中集成文件和目录的树形结构，并通过视图组件（如QTreeView、QListView、QTabView等）展示给用户。

以下是 QFileSystemModel 类的一些重要函数：

函数	描述
`QFileSystemModel(QObject *parent = nullptr)`	构造函数，创建一个 `QFileSystemModel` 对象。
`void setRootPath(const QString &path)`	设置模型的根路径，指定从哪个目录开始显示文件系统。
`QString rootPath() const`	获取模型的根路径。
`void setFilter(QDir::Filters filters)`	设置目录过滤器，用于过滤显示的文件和目录。
`void setResolveSymlinks(bool enable)`	设置是否解析符号链接。
`void sort(int column, Qt::SortOrder order)`	对指定列进行排序。
`QModelIndex index(const QString &path, int column = 0) const`	根据文件路径和列号获取模型索引。
`QFileInfo fileInfo(const QModelIndex &index) const`	获取给定索引处的文件信息。
`bool mkdir(const QModelIndex &index, const QString &name)`	在给定索引处的目录中创建新目录。
`bool rmdir(const QModelIndex &index)`	删除给定索引处的目录。
`bool remove(const QModelIndex &index)`	删除给定索引处的文件。
`void directoryLoaded(const QString &path)`	在目录加载完成时发射的信号。
`void fileRenamed(const QString &path, const QString &oldName, const QString &newName)`	在文件重命名时发射的信号。
`QModelIndex setRootPath(const QString &path)`	设置根路径，并返回表示新路径的模型索引。
`QString filePath(const QModelIndex &index) const`	获取给定索引处的文件路径。
`void setReadOnly(bool enable)`	设置模型为只读模式。
`bool isReadOnly() const`	判断模型是否为只读模式。
`void setNameFilters(const QStringList &filters)`	设置名称过滤器，用于限制模型中显示的文件类型。
`QStringList nameFilters() const`	获取当前的名称过滤器。
`void setRootIndex(const QModelIndex &index)`	设置根索引。
`QModelIndex rootIndex() const`	获取当前的根索引。
`QModelIndex index(int row, int column, const QModelIndex &parent = QModelIndex()) const`	获取模型索引。
`QModelIndex parent(const QModelIndex &index) const`	获取给定索引的父索引。
`int rowCount(const QModelIndex &parent = QModelIndex()) const`	获取给定父索引下的行数。
`int columnCount(const QModelIndex &parent = QModelIndex()) const`	获取给定父索引下的列数。
`QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const`	获取模型数据。

当需要使用此模型时，我们需要导入QFileSystemModel组件，并在主类内定义QFileSystemModel类型的模型指针，并在主函数内通过new QFileSystemModel新建类，通过model->setRootPath设置默认停留的指针位置，最后调用model->setNameFilters设置过滤器，此处我们只需要显示*.exe,*.txt,*.mp4三种格式即可，最后使用ui->treeView->setModel将此模型设置到组件内即可，其完整代码非常简单，如下所示；

MainWindow::MainWindow(QWidget *parent) :QMainWindow(parent),ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    // 新建类指针
    model=new QFileSystemModel(this);

    // 设置根目录
    model->setRootPath(QDir::currentPath());

    // 设置过滤器,只过滤出txt,mp4
    QStringList filter;
    filter << "*.txt" << "*.mp4";

    // 使用过滤器
    model->setNameFilters(filter);
    model->setNameFilterDisables(false);

    // 设置数据模型
    ui->treeView->setModel(model);
}

数据模型内的选中项可通过使用模型内提供的各种方法来实现取值，例如使用model->isDir可获取到是否为目录，通过model->filePath则可用于得到文件的路径等。

// 被点击后触发
void MainWindow::on_treeView_clicked(const QModelIndex &index)
{
    // 是否是目录
    ui->chkIsDir->setChecked(model->isDir(index));
    // 文件路径
    ui->LabPath->setText(model->filePath(index));

    // 文件类型
    ui->LabType->setText(model->type(index));

    // 文件名
    ui->LabFileName->setText(model->fileName(index));

    // 文件的大小
    int sz=model->size(index)/1024;
    if (sz<1024)
    {

        ui->LabFileSize->setText(QString("%1 KB").arg(sz));
    }
    else
    {
        ui->LabFileSize->setText(QString::asprintf("%.1f MB",sz/1024.0));
    }
}

运行后则可以通过点击不同的目录树展开，由于设置了只过滤特定的文件所以此处显示的结果如下所示；