devbox
盐析白兔
这个屌丝很懒，什么也没留下！
关注作者
热门标签
热门文章
当前位置:   article > 正文

QT疑难杂症之如何使用自定义模型实现文件系统模型？类似QFileSystemModel，却比QFileSystemModel更好用_qt 自定义qfilesystemmodel

作者：盐析白兔 | 2024-06-28 02:50:31

赞

踩

qt 自定义qfilesystemmodel

简介

本文讨论了QT文件系统模型QFileSystemModel的不足之处，并且讨论了改进目标，如何实现自定义文件系统模型，以及进一步改进的空间。

【QT免费公开课】您可以到这里观看大量的QT视频课程

【QT付费视频课程】QT核心模块原理与源码分析

【QT付费视频课程】QT Widgets应用程序优化

【QT付费视频课程】QT QML应用程序优化

目录

QFileSystemModel的不足之处

改进目标

自定义文件系统模型

进一步改进的空间

正文

QFileSystemModel的不足之处

QFileSystemModel文件系统模型在实际使用过程中，经常先调用setRootPath()函数设置 一个目录作为根路径。

QFileSystemModel的setRootPath函数
QFileSystemModel实际使用过程中遇到两个问题：

一个问题是在搭配QTreeView和QTreeWidget使用时， 即使已经调用了这个函数，还需进一步调用QTreeView的setRootIndex()函数，才能在控件中只显示根路径中的文件和目录；否则仍然是显示计算机中的所有驱动器的信息。

QTreeView的setRootIndex()函数
另一个问题是在搭配QML的TreeView使用时，在QML中TreeView没有setRootIndex之类的函数，因此总是显示计算机中的所有驱动器的信息。

改进目标

本次的改进目标只有一个，就是实现一个自定义的文件系统模型，只要调用了setRootPath()函数指定了根路径，那么不管是和 QTreeView或QTreeWidget搭配使用，还是和QML的TreeView搭配使用，总是只显示根路径中的文件和目录。比如在根路径设置为 d:\butianyun的情况下，效果如图所示：

ButianyunFileSystemModel和QTreeView搭配使用

ButianyunFileSystemModel和QML中的TreeView搭配使用

自定义文件系统模型

使用自定义模型实现的文件系统模型时，从QAbstractItemModel派生一个新的类型ButianyunFileSystemModel。

头文件如下所示：

/**********************************************************************************
****************** Butianyun QT Video Lesson V2 ***********************************
*********** BUTIANYUN， QT Programming Trainning Professional **********************
***********************************************************************************/

#ifndef BUTIANYUNFILESYSTEMMODEL_H
#define BUTIANYUNFILESYSTEMMODEL_H

#include <QAbstractItemModel>


struct ButianyunFileSystemModelPrivate;

class ButianyunFileSystemModel : public QAbstractItemModel
{
    Q_OBJECT
    Q_DECLARE_PRIVATE(ButianyunFileSystemModel)
    Q_PROPERTY(QString rootPath READ rootPath WRITE setRootPath NOTIFY rootPathChanged)
    Q_PROPERTY(QModelIndex rootIndex READ rootIndex CONSTANT)

public:
    Q_INVOKABLE explicit ButianyunFileSystemModel(QObject* p = nullptr);
    ~ButianyunFileSystemModel();

    void setRootPath(const QString& value);
    QString rootPath() const;
    QModelIndex rootIndex() const;
    ButianyunFileInfo fileInfo(const QModelIndex& index) const;
    bool isValid(const QModelIndex& index) const;
    QModelIndex index(int row, int column, const QModelIndex &parent = QModelIndex()) const override;
    QModelIndex parent(const QModelIndex &child) const override;
    int rowCount(const QModelIndex &parent = QModelIndex()) const override;
    int columnCount(const QModelIndex &parent = QModelIndex()) const override;
    bool hasChildren(const QModelIndex &parent = QModelIndex()) const override;
    QVariant headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const override;
    QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override;
    QHash<int,QByteArray> roleNames() const override;
    Qt::ItemFlags flags(const QModelIndex &index) const override;
    QModelIndex index(const QString& filePath, const QModelIndex &parent = QModelIndex()) const;


signals:
    void rootPathChanged();

public slots:
    void clearCache();

private:
    QSharedPointer<ButianyunFileSystemModelPrivate> d_ptr;
    Q_DISABLE_COPY(ButianyunFileSystemModel)
};

#endif // BUTIANYUNFILESYSTEMMODEL_H


  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54

C++实现文件如下：

/**********************************************************************************
****************** Butianyun QT Video Lesson V2 ***********************************
*********** BUTIANYUN， QT Programming Trainning Professional **********************
***********************************************************************************/

#include "butianyunfilesystemmodel.h"


void ButianyunFileSystemModel::setRootPath(const QString& value)
{
    Q_D(ButianyunFileSystemModel);
    QFileInfo fi(value);
    if (fi.absoluteFilePath() == d->_rootPath)
    {
        return;
    }

    d->_id_to_info_cache.clear();
    d->_path_to_id_cache.clear();
    d->_rootPath = fi.absoluteFilePath();
    quintptr id = d->_id_to_info_cache.size() + 1;
    d->_rootIndex = createIndex(0, 0, reinterpret_cast<const void*>(id));
    emit rootPathChanged();
}

QString ButianyunFileSystemModel::rootPath() const
{
    const ButianyunFileSystemModelPrivate* d = d_func();
    return d->_rootPath;
}

QModelIndex ButianyunFileSystemModel::rootIndex() const
{
    const ButianyunFileSystemModelPrivate* d = d_func();
    return d->_rootIndex;
}

ButianyunFileInfo ButianyunFileSystemModel::fileInfo(const QModelIndex& index) const
{
    const ButianyunFileSystemModelPrivate* d = d_func();
    quintptr pid = index.internalId();
    if (0 == pid)
    {
        if (index.parent().isValid())
        {
            return ButianyunFileInfo();
        }
        pid = 1;
    }
    auto it = d->_id_to_info_cache.find(pid);
    if (it == d->_id_to_info_cache.end())
    {
        return ButianyunFileInfo();
    }
    return it.value();
}

bool ButianyunFileSystemModel::isValid(const QModelIndex& index) const
{
   const ButianyunFileSystemModelPrivate* d = d_func();
   if (index.column() >= ButianyunFileInfoRoleCount)
   {
       return false;
   }

    quintptr pid = index.internalId();
    if (0 == pid)
    {
        if (index.parent().isValid())
        {
            return false;
        }
        pid = 1;
    }
    auto it = d->_id_to_info_cache.find(pid);
    if (it == d->_id_to_info_cache.end())
    {
        return false;
    }
    return it.value().isValid(pid);
}

static QFileInfoList butianyun_get_file_info_list(const QString& filePath)
{
    QDir dir(filePath);
    return  dir.entryInfoList(QDir::Filter::NoDotAndDotDot |QDir::Drives | QDir::Dirs |QDir::Files,
                              QDir::DirsFirst |QDir::Name |QDir::Type |QDir::IgnoreCase);
}

QModelIndex ButianyunFileSystemModel::index(int row, int column, const QModelIndex &parent) const
{
   ButianyunFileSystemModelPrivate* d = const_cast<ButianyunFileSystemModel*>(this)->d_func();
   if (row < 0 || column < 0 || column >= ButianyunFileInfoRoleCount)
   {
       return QModelIndex();
   }
   quintptr pid = parent.internalId();
   auto parent_fileinfo = fileInfo(parent);

   if (0 == pid && !parent.parent().isValid())
   {
       pid = 1;
   }
   if (!parent_fileinfo.isValid(pid))
   {
       return QModelIndex();
   }

   QFileInfoList list = butianyun_get_file_info_list(parent_fileinfo.filePath);
   if (row >= list.length())
   {
       return QModelIndex();
   }

   quintptr this_id = 0;
   return createIndex(row, column, reinterpret_cast<const void *>(this_id));
}

QModelIndex ButianyunFileSystemModel::parent(const QModelIndex &child) const
{
    const ButianyunFileSystemModelPrivate* d = d_func();
    if (!child.isValid())
    {
        return QModelIndex();
    }

    quintptr id = child.internalId();
    auto fileinfo = fileInfo(child);
    if (!fileinfo.isValid(id) || 0 == fileinfo.level)
    {
       return QModelIndex();
    }

    int index = fileinfo.filePath.lastIndexOf("/");
    if (index <= 0)
    {
        return QModelIndex();
    }

    QString filePath = fileinfo.filePath.left(index);
    if (filePath.isEmpty())
    {
        return QModelIndex();
    }

    auto it = d->_path_to_id_cache.find(filePath);
    if (it == d->_path_to_id_cache.end())
    {
        return QModelIndex();
    }

    if (it.value() != fileinfo.pid)
    {
        return QModelIndex();
    }

    quintptr pid = fileinfo.pid;
    auto it2 = d->_id_to_info_cache.find(pid);
    if (it2 == d->_id_to_info_cache.end())
    {
        return QModelIndex();
    }
    fileinfo = it2.value();
    if (pid != fileinfo.id)
    {
        return QModelIndex();
    }
    return createIndex(fileinfo.row, 0, pid);
}

int ButianyunFileSystemModel::rowCount(const QModelIndex &parent) const
{
    quintptr pid = parent.internalId();
    auto parent_fileinfo = fileInfo(parent);
    if (0 == pid && !parent.parent().isValid())
    {
        pid = 1;
    }
    if (!parent_fileinfo.isValid(pid))
    {
        return 0;
    }

    QFileInfoList list = butianyun_get_file_info_list(parent_fileinfo.filePath);
    return list.length();
}

int ButianyunFileSystemModel::columnCount(const QModelIndex &parent) const
{
    return ButianyunFileInfoRoleCount;
}

bool ButianyunFileSystemModel::hasChildren(const QModelIndex &parent) const
{
    return rowCount(parent) > 0;
}

QVariant ButianyunFileSystemModel::headerData(int section, Qt::Orientation orientation, int role) const
{
    if (Qt::Horizontal == orientation)
    {
        if (Qt::DisplayRole == role)
        {
        switch (section + Qt::UserRole + 1)
        {
            case Role_ButianyunFileName:
                 return tr("Name");
            case Role_ButianyunFileSize:
                 return tr("Size");
            case Role_ButianyunFileType:
                 return tr("Type");
            case Role_ButianyunFileLastModified:
                 return tr("Data Modified");
            default:
                 return QVariant();
            }
        }
    }
    else
    {
       if (Qt::DisplayRole == role)
       {
         return QString::number(section);
       }
    }
    return QVariant();
}

QVariant ButianyunFileSystemModel::data(const QModelIndex &index, int role) const
{
    if (Qt::DisplayRole != role && Qt::DecorationRole != role)
    {
        return QVariant();
    }

    if (!index.isValid())
    {
        return QVariant();
    }
    if (index.column() >= ButianyunFileInfoRoleCount)
    {
        return false;
    }

    quintptr pid = index.internalId();
    if (0 == pid && !index.parent().isValid())
    {
        pid = 1;
    }
    auto fileinfo = fileInfo(index);

    if (!fileinfo.isValid(pid))
    {
        return QVariant();
    }

    QFileInfo fi(fileinfo.filePath);
    switch (index.column() + Qt::UserRole + 1)
    {
    case Role_ButianyunFileName:
        if (Qt::DisplayRole == role)
        {
            return fi.fileName();
        }
        else if (Qt::DecorationRole == role)
        {
            return fileinfo.fileicon();
        }

    case Role_ButianyunFileSize:
    {
         return fileinfo.filesize();
    }

    case Role_ButianyunFileType:
        return fileinfo.filetype();

    case Role_ButianyunFileLastModified:
        return fi.lastModified().toString("yyyy-MM-dd hh:mm");

    default:
         return QVariant();
    }
    return QVariant();
}

QHash<int,QByteArray> ButianyunFileSystemModel::roleNames() const
{
    QHash<int,QByteArray> roles;
    roles = QAbstractItemModel::roleNames();
    roles[Role_ButianyunFileName] = QStringLiteral("FileName").toUtf8();
    roles[Role_ButianyunFileSize] = QStringLiteral("FileSize").toUtf8();
    roles[Role_ButianyunFileType] = QStringLiteral("FileType").toUtf8();
    roles[Role_ButianyunFileLastModified] = QStringLiteral("LastModified").toUtf8();
    return roles;
}

Qt::ItemFlags ButianyunFileSystemModel::flags(const QModelIndex &index) const
{
    return Qt::ItemIsEnabled | Qt::ItemIsSelectable;
}

QModelIndex ButianyunFileSystemModel::index(const QString& filePath, const QModelIndex &parent) const
{
    ButianyunFileSystemModelPrivate* d = const_cast<ButianyunFileSystemModel*>(this)->d_func();
    auto it = d->_path_to_id_cache.find(filePath);
    if (it == d->_path_to_id_cache.end())
    {
        return QModelIndex();
    }
    quintptr pid = parent.internalId();
    if (0 == pid && !parent.parent().isValid())
    {
        pid = 1;
    }
    auto it2 = d->_id_to_info_cache.find(it.value());
    if (it2 == d->_id_to_info_cache.end())
    {
        return QModelIndex();
    }
    ButianyunFileInfo fileinfo = it2.value();
    if (fileinfo.pid != pid && fileinfo.level > 0)
    {
        return QModelIndex();
    }
    return createIndex(fileinfo.row, 0, pid);
}


  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309
  • 310
  • 311
  • 312
  • 313
  • 314
  • 315
  • 316
  • 317
  • 318
  • 319
  • 320
  • 321
  • 322
  • 323
  • 324
  • 325
  • 326
  • 327
  • 328

和QTreeView搭配使用的测试代码如下所示：

    ButianyunFileSystemModel* model = new ButianyunFileSystemModel(this);
    model->setRootPath(R"(d:\butianyun)");
    QTreeView* tree = new QTreeView();
    tree->setModel(model);
    tree->setRootIndex(model->index(model->rootPath()));


  • 1
  • 2
  • 3
  • 4
  • 5
  • 6

和 QML 的 TreeView搭配使用的测试代码如下所示：

TreeView {
id: tree
anchors.topMargin: header.height + button_reset.height
anchors.fill: parent
model: fsmodel
columnWidthProvider: get_column_width
columnSpacing: 10
delegate: TreeViewDelegate {}
}

进一步改进的空间

目前这个实现版本的文件系统模型 ButianyunFileSystemModel，初步实现了前面讨论的改进目标。这个类型还存在一些进一步的改进空间，比如：

根目录中的文件变化的处理：QFileSystemModel能够感知到文件变化通知，并能做出对应的响应，而ButianyunFileSystemModel还不能感知到文件变化通知。ButianyunFileSystemModel提供了resetCache()函数用于手动触发重置操作。

没有实现QT模型类型中的常见操作canFetchMore()和 fetchMore()函数： QFileSystemModel实现了这两个函数。ButianyunFileSystemModel在内部使用 QHash 做了一定的缓存，已经避免了在目录中有很多文件时一次查询过多文件。

本文相关的另一个文章：

QT QML：QT疑难杂症之QML程序中如何使用文件系统模型QFileSystemModel？

【QT免费公开课】您可以到这里观看大量的QT视频课程

【QT付费视频课程】QT核心模块原理与源码分析

【QT付费视频课程】QT Widgets应用程序优化

【QT付费视频课程】QT QML应用程序优化

总结

本文讨论了QT文件系统模型QFileSystemModel的不足之处，并且讨论了改进目标，如何实现自定义文件系统模型，以及进一步改进的空间。

如果您认为这篇文章对您有所帮助，请您一定立即点赞+喜欢+收藏，本文作者将能从您的点赞+喜欢+收藏中获取到创作新的好文章的动力。如果您认为作者写的文章还有一些参考价值，您也可以关注这篇文章的作者。

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/盐析白兔/article/detail/764661
推荐阅读
相关标签

Copyright © 2003-2013 www.wpsshop.cn 版权所有，并保留所有权利。

  

闽ICP备14008679号