Qt进阶开发：QFileSystemModel的使用

news2025/7/16 5:00:43

文章目录

    • 一、QFileSystemModel的基本介绍
    • 二、QFileSystemModel的基本使用
      • 2.1 在 QTreeView 中使用
      • 2.2 在 QListView 中使用
      • 2.3 在 QTableView 中使用
    • 三、QFileSystemModel的常用API
      • 3.1 设置根目录
      • 3.2 过滤文件
        • 3.2.1 仅显示文件
        • 3.2.2 只显示特定后缀的文件
        • 3.2.3 只显示目录
    • 四、监听文件系统变化
      • 1. QFileSystemModel常见信号
      • 2. 信号的使用示例
        • 2.1 监听目录加载完成
        • 2.2 监听文件重命名
        • 2.3 监听根路径变化
        • 2.4 监听文件/目录添加
        • 2.5 监听文件/目录删除
      • 3. 动态更新QLabel显示选中文件
      • 4.右键菜单的实现
    • 五、继承QFileSystemModel并进行自定义

一、QFileSystemModel的基本介绍

  QFileSystemModel 是 Qt 框架中用于管理和显示本地文件系统的 MVC 结构中的 Model。它可以与 QTreeView、QListView 或 QTableView 结合使用，实现文件管理功能。相比 QDirModel，QFileSystemModel 只会加载需要的目录，支持懒加载，在处理大文件夹时更高效。

主要特点：

  • 继承自 QAbstractItemModel，提供标准的文件系统数据模型。
  • 懒加载（Lazy Loading）：不会一次性加载整个文件系统，只会加载需要的部分，提升性能。
  • 支持文件过滤（setFilter()、setNameFilters()）。
  • 自动监听文件系统变化，实时更新 UI。

二、QFileSystemModel的基本使用

2.1 在 QTreeView 中使用

#include <QApplication>
#include <QTreeView>
#include <QFileSystemModel>

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

    QFileSystemModel model;
    model.setRootPath(QDir::homePath());  // 设置根目录

    QTreeView treeView;
    treeView.setModel(&model);
    treeView.setRootIndex(model.index(QDir::homePath())); // 绑定视图
    treeView.show();

    return app.exec();
}

在这里插入图片描述

2.2 在 QListView 中使用

QListView listView;
listView.setModel(&model);
listView.setRootIndex(model.index(QDir::homePath()));
listView.show();

在这里插入图片描述

2.3 在 QTableView 中使用

QTableView tableView;
tableView.setModel(&model);
tableView.setRootIndex(model.index(QDir::homePath()));
tableView.show();

在这里插入图片描述

三、QFileSystemModel的常用API

在这里插入图片描述

3.1 设置根目录

model.setRootPath(QDir::homePath());  // 设置为用户目录

注意：setRootPath() 只是设置数据模型的根目录，并不会影响 QTreeView 显示的目录。要限制 QTreeView 的显示范围，需使用 setRootIndex()。

3.2 过滤文件

3.2.1 仅显示文件
model.setFilter(QDir::Files | QDir::NoDotAndDotDot);

QDir::Files 只显示文件，QDir::NoDotAndDotDot 过滤掉 . 和 … 目录。

3.2.2 只显示特定后缀的文件
model.setNameFilters(QStringList() << "*.cpp" << "*.h");
model.setNameFilterDisables(false); // 过滤掉不符合的文件

这将只显示 .cpp 和 .h 文件。

3.2.3 只显示目录
model.setFilter(QDir::Dirs | QDir::NoDotAndDotDot);

只显示目录，隐藏所有文件。

四、监听文件系统变化

1. QFileSystemModel常见信号

在这里插入图片描述

2. 信号的使用示例

2.1 监听目录加载完成

当 QFileSystemModel 完成某个目录的加载时，可以使用 directoryLoaded() 信号：

#include <QApplication>
#include <QTreeView>
#include <QFileSystemModel>
#include <QDebug>

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

    QFileSystemModel model;
    QObject::connect(&model, &QFileSystemModel::directoryLoaded, 
                     [](const QString &path) {
                         qDebug() << "目录加载完成：" << path;
                     });

    model.setRootPath(QDir::homePath());

    QTreeView treeView;
    treeView.setModel(&model);
    treeView.setRootIndex(model.index(QDir::homePath()));
    treeView.show();

    return app.exec();
}

解释：

  • 当某个目录的内容加载完成时，会输出 “目录加载完成：/home/user”（Linux/macOS）或 “目录加载完成：C:/Users/xxx”（Windows）。
  • 适用场景：可以在目录加载完成后执行额外的操作，比如统计文件数量、更新 UI 状态等。
2.2 监听文件重命名

如果用户在文件管理器中修改了文件名，可以捕获 fileRenamed() 信号：

QObject::connect(&model, &QFileSystemModel::fileRenamed, 
                 [](const QString &path, const QString &oldName, const QString &newName) {
                     qDebug() << "文件重命名：" << path + "/" + oldName << " -> " << newName;
                 });

解释：

  • fileRenamed(path, oldName, newName) 提供了文件所在目录、旧文件名和新文件名。
  • 适用场景：可以记录日志、同步到数据库或通知 UI 更新。
2.3 监听根路径变化

当 setRootPath() 发生变化时，触发 rootPathChanged()：

QObject::connect(&model, &QFileSystemModel::rootPathChanged, 
                 [](const QString &newPath) {
                     qDebug() << "根目录更改为：" << newPath;
                 });

适用场景：当用户更改文件浏览的根目录时，可以执行特定操作，比如清除旧数据、更新 UI 等。

2.4 监听文件/目录添加

当新文件或目录被创建时，会触发 rowsInserted() 信号：

QObject::connect(&model, &QFileSystemModel::rowsInserted, 
                 [&model](const QModelIndex &parent, int start, int end) {
                     for (int row = start; row <= end; ++row) {
                         QModelIndex index = model.index(row, 0, parent);
                         qDebug() << "新文件/文件夹：" << model.filePath(index);
                     }
                 });

解释：

  • rowsInserted() 触发时，会输出新文件或目录的路径。
  • 适用场景：当用户创建新文件/文件夹时，自动执行相应的 UI 更新或日志记录。
2.5 监听文件/目录删除

当某个文件或文件夹被删除时，会触发 rowsRemoved() 信号：

QObject::connect(&model, &QFileSystemModel::rowsRemoved, 
                 [](const QModelIndex &parent, int start, int end) {
                     qDebug() << "文件/文件夹删除：" << start << "到" << end;
                 });

3. 动态更新QLabel显示选中文件

#include <QApplication>
#include <QTreeView>
#include <QFileSystemModel>
#include <QLabel>
#include <QVBoxLayout>
#include <QWidget>
#include <QItemSelectionModel>

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

    QFileSystemModel model;
    model.setRootPath(QDir::homePath());

    QTreeView treeView;
    treeView.setModel(&model);
    treeView.setRootIndex(model.index(QDir::homePath()));

    QLabel label;
    label.setText("选中文件路径显示区域");

    // 监听选中项变化
    QObject::connect(treeView.selectionModel(), &QItemSelectionModel::selectionChanged, 
                     [&model, &treeView, &label](const QItemSelection &selected, const QItemSelection &) {
                         if (!selected.indexes().isEmpty()) {
                             QModelIndex index = selected.indexes().first();
                             label.setText(model.filePath(index));
                         }
                     });

    // 设置 UI 布局
    QWidget window;
    QVBoxLayout layout;
    layout.addWidget(&treeView);
    layout.addWidget(&label);
    window.setLayout(&layout);
    window.show();

    return app.exec();
}

输出显示：
在这里插入图片描述

4.右键菜单的实现

可以为 QTreeView 添加右键菜单，实现文件操作（打开、删除等）。

#include <QMenu>
#include <QAction>
#include <QDesktopServices>
#include <QUrl>

void onContextMenu(const QPoint &pos) {
    QModelIndex index = treeView.indexAt(pos);
    if (!index.isValid()) return;

    QMenu menu;
    QAction *openAction = new QAction("打开", &menu);
    QAction *deleteAction = new QAction("删除", &menu);
    
    connect(openAction, &QAction::triggered, [index, &model]() {
        QString path = model.filePath(index);
        QDesktopServices::openUrl(QUrl::fromLocalFile(path));
    });

    connect(deleteAction, &QAction::triggered, [index, &model]() {
        model.remove(index);
    });

    menu.addAction(openAction);
    menu.addAction(deleteAction);
    menu.exec(treeView.viewport()->mapToGlobal(pos));
}

五、继承QFileSystemModel并进行自定义

继承 QFileSystemModel 并进行自定义，可以用来修改文件显示方式、拦截用户操作、隐藏某些文件或添加额外的功能。
可以通过继承 QFileSystemModel来：

  • 自定义文件名显示（如：在文件名前加上 [文件] 或 [目录]）。
  • 自定义文件图标。
  • 隐藏某些文件/目录。
  • 拦截文件删除或重命名操作。

示例 1：重写 data() 修改文件显示
默认情况下，QFileSystemModel 只显示文件名。如果我们想要修改显示内容（如：文件名前加上类型信息），可以重写 data() 方法：

#include <QFileSystemModel>
#include <QDebug>

class CustomFileSystemModel : public QFileSystemModel {
public:
    explicit CustomFileSystemModel(QObject *parent = nullptr) : QFileSystemModel(parent) {}

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

        if (role == Qt::DisplayRole) {  // 修改显示文本
            QString fileName = QFileSystemModel::data(index, Qt::DisplayRole).toString();
            if (isDir(index))
                return "[目录] " + fileName;
            else
                return "[文件] " + fileName;
        }

        return QFileSystemModel::data(index, role);
    }
};

示例 2：自定义文件图标
如果想要为特定类型的文件设置不同的图标（如 .txt 用文本图标，.cpp 用代码图标），可以重写 data() 的 Qt::DecorationRole：

#include <QFileIconProvider>
#include <QFileInfo>

class CustomFileSystemModel : public QFileSystemModel {
public:
    explicit CustomFileSystemModel(QObject *parent = nullptr) : QFileSystemModel(parent) {}

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

        if (role == Qt::DecorationRole) {
            QFileInfo fileInfo = this->fileInfo(index);

            if (fileInfo.suffix() == "txt")
                return QIcon(":/icons/text.png"); // 替换为你的图标
            else if (fileInfo.suffix() == "cpp" || fileInfo.suffix() == "h")
                return QIcon(":/icons/code.png"); // 替换为你的图标
            else if (fileInfo.isDir())
                return QIcon(":/icons/folder.png"); // 替换为你的文件夹图标
        }

        return QFileSystemModel::data(index, role);
    }
};

示例 2：自定义双击打开文件
如果希望在双击文件时执行特定操作（如：打开文件或显示信息），可以在 QTreeView 中监听 doubleClicked() 信号：

QObject::connect(&treeView, &QTreeView::doubleClicked, [&](const QModelIndex &index) {
    QString filePath = model.filePath(index);
    if (model.isDir(index)) {
        qDebug() << "双击打开目录：" << filePath;
    } else {
        qDebug() << "双击打开文件：" << filePath;
        QDesktopServices::openUrl(QUrl::fromLocalFile(filePath));
    }
});

下面是一个完整的示例，将以上功能整合到 QTreeView 中：

#include <QApplication>
#include <QTreeView>
#include <QFileSystemModel>
#include <QVBoxLayout>
#include <QWidget>
#include <QMessageBox>
#include <QDesktopServices>
#include <QUrl>

class CustomFileSystemModel : public QFileSystemModel {
public:
    explicit CustomFileSystemModel(QObject *parent = nullptr) : QFileSystemModel(parent) {}

    QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override {
        if (!index.isValid()) return QVariant();
        if (role == Qt::DisplayRole) {
            QString fileName = QFileSystemModel::data(index, Qt::DisplayRole).toString();
            return isDir(index) ? "[目录] " + fileName : "[文件] " + fileName;
        }
        return QFileSystemModel::data(index, role);
    }
};

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    
    CustomFileSystemModel model;
    model.setRootPath(QDir::homePath());

    QTreeView treeView;
    treeView.setModel(&model);
    treeView.setRootIndex(model.index(QDir::homePath()));

    QObject::connect(&treeView, &QTreeView::doubleClicked, [&](const QModelIndex &index) {
        QString filePath = model.filePath(index);
        QDesktopServices::openUrl(QUrl::fromLocalFile(filePath));
    });

	treeView.resize(800, 600);
    treeView.show();
    return app.exec();
}

在这里插入图片描述

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/2328404.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

【C语言】字符串处理函数：strtok和strerror

【C语言】字符串处理函数：strtok和strerror

在C语言中&#xff0c;字符串处理是编程的基础之一。本文将详细讲解两个重要的字符串处理函数&#xff1a;strtok和strerror 一、strtok函数 strtok函数用于将字符串分割成多个子串&#xff0c;这些子串由指定的分隔符分隔。其原型定义如下&#xff1a; char *strtok(char *s…
阅读更多...
go语言：开发一个最简单的用户登录界面

go语言：开发一个最简单的用户登录界面

1.用deepseek生成前端页面&#xff1a; 1.提问&#xff1a;请你用html帮我设计一个用户登录页面&#xff0c;要求特效采用科技感的背景渲染加粒子流动&#xff0c;用css、div、span标签&#xff0c;并给出最终合并后的代码。 生成的完整代码如下&#xff1a; <!DOCTYPE h…
阅读更多...
《Maven高级应用：继承聚合设计与私服Nexus实战指南》

《Maven高级应用：继承聚合设计与私服Nexus实战指南》

一、 Maven的继承和聚合 1.什么是继承 Maven 的依赖传递机制可以一定程度上简化 POM 的配置&#xff0c;但这仅限于存在依赖关系的项目或模块中。当一个项目的多个模块都依赖于相同 jar 包的相同版本&#xff0c;且这些模块之间不存在依赖关系&#xff0c;这就导致同一个依赖…
阅读更多...
C语言数字分隔题目

C语言数字分隔题目

一、题目引入 编写一个程序,打印出从用户输入的数字开始,递减到1的序列。要求每次打印一行,数字之间用逗号分隔,最后一个数字后面没有逗号。 二、代码展示 三、运行结果 四、思路分析 1.先用一个for循环对输入的数字进行递减 2.再对for循环里面的数字进行筛选 如果大于1 …
阅读更多...
ARM-外部中断，ADC模数转换器

ARM-外部中断，ADC模数转换器

根据您提供的图片&#xff0c;我们可以看到一个S3C2440微控制器的中断处理流程图。这个流程图展示了从中断请求源到CPU的整个中断处理过程。以下是流程图中各个部分与您提供的寄存器之间的关系&#xff1a; 请求源&#xff08;带sub寄存器&#xff09;&#xff1a; 这些是具体的…
阅读更多...
git克隆数据失败

git克隆数据失败

场景&#xff1a;当新到一家公司&#xff0c;然后接手了上一个同时的电脑&#xff0c;使用git克隆代码一直提示无法访问&#xff0c;如图 原因&#xff1a;即使配置的新的用户信息。但是window记录了上一个同事的登录信息&#xff0c;上一个同事已经被剔除权限&#xff0c;再拉…
阅读更多...
自动化备份全网服务器数据平台

自动化备份全网服务器数据平台

自动化备份全网服务器数据平台 项目背景知识 总体需求 某企业里有一台Web服务器&#xff0c;里面的数据很重要&#xff0c;但是如果硬盘坏了数据就会丢失&#xff0c;现在领导要求把数据做备份&#xff0c;这样Web服务器数据丢失在可以进行恢复。要求如下&#xff1a;1.每天0…
阅读更多...
AI Agent系列(八) -基于ReAct架构的前端开发助手(DeepSeek)

AI Agent系列(八) -基于ReAct架构的前端开发助手(DeepSeek)

AI Agent系列【八】 项目目标一、核心功能设计二、技术栈选择三、Python实现3.1 设置基础环境3.2 定义AI前端生成的类3.4 实例化3.5 Flask路由3.6 主程序执行 四、 功能测试 项目目标 开发一个能够协助HTMLJSCSS前端设计的AI Agent&#xff0c;通过在网页中输入相应的问题&am…
阅读更多...
一文学会云服务器配置Milvus向量数据库

一文学会云服务器配置Milvus向量数据库

服务器准备 首先&#xff0c;我们需要进行服务器的准备&#xff0c;这里准备的是RTX-4090服务器 连接我们已经创建好的服务器&#xff0c;这里可使用MobaXterm进行ssh连接 ssh funhpcIP地址 一键完成Docker配置 注&#xff1a;docker的旧版本不一定被称为docker&#xff0c;doc…
阅读更多...
19685 握手问题

19685 握手问题

19685 握手问题 ⭐️难度&#xff1a;简单 &#x1f31f;考点&#xff1a;2024、省赛、数学 &#x1f4d6; &#x1f4da; package test ;import java.util.Scanner; public class Main {public static void main(String[] args) {Scanner scanner new Scanner(System.in);…
阅读更多...
【MySQL数据库】锁机制

【MySQL数据库】锁机制

概述 锁&#xff1a;是计算机协调多个进程或者线程并发访问某一资源的机制。在数据库中&#xff0c;除了传统的计算资源&#xff08;CPU、RAM、IO&#xff09;的争用以外。数据也是一种供多用户共享的资源。如何保证数据的并发访问的一致性、有效性是所有数据库必须解决的一个…
阅读更多...
react redux的学习，单个reducer

react redux的学习，单个reducer

redux系列文章目录 一 什么redux&#xff1f; redux是一个专门用于做状态管理的JS库(不是react插件库)。它可以用在react, angular, vue等项目中, 但基本与react配合使用。集中式管理react应用中多个组件共享的状 简单来说&#xff0c;就是存储页面的状态值的一个库&#xf…
阅读更多...
分布式控制技术赋能智慧工厂精准控制研究

分布式控制技术赋能智慧工厂精准控制研究

摘要&#xff1a;本文聚焦于分布式控制技术在智慧工厂精准控制中的应用。详细阐述了分布式控制系统&#xff08;DCS&#xff09;、边缘计算机、边边协同技术以及分布式计算等关键要素在实现精准控制中的作用机制。同时&#xff0c;分析了云边协同模式存在占用带宽、单点故障、数…
阅读更多...
清明节里清明菜：软萩（拟人版介绍）

清明节里清明菜：软萩（拟人版介绍）

好像人们无论过任何节&#xff0c;总是离不开吃 清明节里吃清明菜&#xff0c;你采摘了吗&#xff1f; 姓名 软萩&#xff0c;也叫鼠麴草、清明菜、软雀&#xff0c;学名鼠曲草。 一些地方性小名&#xff08;防止大家找不到组织&#xff0c;已知的都附上&#xff09;&#xf…
阅读更多...
JavaWeb学习--MyBatis-Plus整合SpringBoot的ServiceImpl方法（增加，修改与删除部分）

JavaWeb学习--MyBatis-Plus整合SpringBoot的ServiceImpl方法（增加，修改与删除部分）

接下来是常用的增加&#xff0c;修改以及删除部分 首先是增加部分&#xff0c;增加一个新的数据 Testpublic void testInsert() {// 添加一个新用户记录Student s new Student();s.setName("NewStudent");s.setAge(25);boolean saved studentService.save(s);//可以…
阅读更多...
AiCube 试用 - 创建流水灯工程

AiCube 试用 - 创建流水灯工程

AiCube 试用 - 创建流水灯工程 本文介绍了 Aiapp-ISP 仿真调试平台软件的 AiCube 工具&#xff0c;实现流水灯工程的快速创建的主要流程。 下载运行 下载 最新版 AIapp-ISP 软件&#xff1b; 解压并打开该软件&#xff0c;右侧操作界面选择并进入 Keil 仿真设置 标签项&…
阅读更多...
GISBox：核心功能免费的一站式三维GIS处理平台

GISBox：核心功能免费的一站式三维GIS处理平台

大家好&#xff0c;今天为大家介绍的软件是GISBox&#xff1a;一款核心功能免费的一站式三维GIS处理平台&#xff0c;主要是适用于数字孪生。下面&#xff0c;我们将从软件的主要功能、支持的系统、软件官网等方面对其进行简单的介绍。 软件官网&#xff1a;http://www.gisbox.…
阅读更多...
【论文笔记】DeepSeek-R1 技术报告

【论文笔记】DeepSeek-R1 技术报告

最强开源LLM&#xff0c;性能和效果都很棒&#xff1b;在数学、代码这种有标准正确答案的场景&#xff0c;表现尤为突出&#xff1b;一些其他场景的效果&#xff0c;可能不如DeepSeek-V3和Qwen。 Deepseek-R1没有使用传统的有监督微调sft方法来优化模型&#xff0c;而使用了大规…
阅读更多...
基于javaweb的SSM羽毛球会员俱乐部系统场馆课程运动设计与实现(源码+文档+部署讲解）

基于javaweb的SSM羽毛球会员俱乐部系统场馆课程运动设计与实现(源码+文档+部署讲解）

技术范围&#xff1a;SpringBoot、Vue、SSM、HLMT、Jsp、PHP、Nodejs、Python、爬虫、数据可视化、小程序、安卓app、大数据、物联网、机器学习等设计与开发。 主要内容&#xff1a;免费功能设计、开题报告、任务书、中期检查PPT、系统功能实现、代码编写、论文编写和辅导、论文…
阅读更多...
[dp4_路径问题] 下降路径最小和 | 最小路径和 | 地下城游戏

[dp4_路径问题] 下降路径最小和 | 最小路径和 | 地下城游戏

目录 1.下降路径最小和 题解 2.最小路径和 题解 3.地下城游戏 题解 做算法题的时候&#xff0c;谨记图画得越详细越好&#xff0c;思路想的越清晰越好&#xff0c;然后再用代码实现一下就好啦 1.下降路径最小和 链接&#xff1a;931. 下降路径最小和 给你一个 n x n 的…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023