QFileSystemModel 类

成员函数文档

[显式] QFileSystemModel::QFileSystemModel(QObject *parent = nullptr)

构造具有给定 父级 的文件系统模型。

[虚拟 noexcept] QFileSystemModel::~QFileSystemModel()

销毁此文件系统模型。

[覆盖虚拟] bool QFileSystemModel::canFetchMore(const QModelIndex &parent) const

重实现了: QAbstractItemModel::canFetchMore(const QModelIndex &parent) const。

[覆盖虚拟] int QFileSystemModel::columnCount(const QModelIndex &parent = QModelIndex()) const

重实现了: QAbstractItemModel::columnCount(const QModelIndex &parent) const。

[重写虚函数] QVariant QFileSystemModel::data(const QModelIndex &index, int role = Qt::DisplayRole) const

重写: QAbstractItemModel::data(const QModelIndex &index, int role) const.

另请参阅setData().

[信号] void QFileSystemModel::directoryLoaded(const QString &path)

此信号在采集线程完成 path 加载时发出。

[重写虚函数] bool QFileSystemModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent)

重写: QAbstractItemModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent).

处理由拖放操作提供的 data，操作以给定的 action 结束，并将其放置在由 row 和 column 以及 parent 指定的模型中的行上。如果操作成功，则返回 true。

另请参阅supportedDropActions().

[重写虚函数受保护] bool QFileSystemModel::event(QEvent *event)

重写: QObject::event(QEvent *e).

[重写虚函数] void QFileSystemModel::fetchMore(const QModelIndex &parent)

重写: QAbstractItemModel::fetchMore(const QModelIndex &parent).

QIcon QFileSystemModel::fileIcon(const QModelIndex &index) const

返回在给定 index 下的模型中存储的项目的图标。

QFileInfo QFileSystemModel::fileInfo(const QModelIndex &index) const

返回在给定 index 下的模型中存储的项目的 QFileInfo。

QString QFileSystemModel::fileName(const QModelIndex &index) const

返回在给定 index 下的模型中存储的项目的文件名。

QString QFileSystemModel::filePath(const QModelIndex &index) const

返回在给定 index 下的模型中存储的项目的路径。

[信号] void QFileSystemModel::fileRenamed(const QString &path, const QString &oldName, const QString &newName)

此信号在文件名从oldName成功重命名为newName时发出。该文件位于目录path中。

QDir::Filters QFileSystemModel::filter() const

返回为目录模型指定的过滤器。

如果没有设置过滤器，默认过滤器为 QDir::AllEntries | QDir::NoDotAndDotDot | QDir::AllDirs。

另请参阅setFilter() 以及 QDir::Filters。

[虚函数重载] Qt::ItemFlags QFileSystemModel::flags(const QModelIndex &index) const

重实现了: QAbstractItemModel::flags(const QModelIndex &index) const.

[虚函数重载] bool QFileSystemModel::hasChildren(const QModelIndex &parent = QModelIndex()) const

重实现了: QAbstractItemModel::hasChildren(const QModelIndex &parent) const.

[虚函数重载] QVariant QFileSystemModel::headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const

重实现了: QAbstractItemModel::headerData(int section, Qt::Orientation orientation, int role) const.

QAbstractFileIconProvider *QFileSystemModel::iconProvider() const

返回此目录模型的文件图标提供者。

另请参阅setIconProvider。

[虚函数重载] QModelIndex QFileSystemModel::index(int row, int column, const QModelIndex &parent = QModelIndex()) const

重实现了: QAbstractItemModel::index(int row, int column, const QModelIndex &parent) const.

QModelIndex QFileSystemModel::index(const QString &path, int column = 0) const

这是一个重载函数。

返回给定path和column的模型项索引。

bool QFileSystemModel::isDir(const QModelIndex &index) const

如果模型项index表示目录，则返回true；否则返回false。

QDateTime QFileSystemModel::lastModified(const QModelIndex &index) const

返回index最后修改的日期和时间（本地时间）。

这是一个重载函数，相当于调用

lastModified(index, QTimeZone::LocalTime);

如果index无效，则返回默认构造的QDateTime。

[自 6.6 版起] QDateTime QFileSystemModel::lastModified(const QModelIndex &index, const QTimeZone &tz) const

返回index最后修改的日期和时间，时间区域为tz。

tz的典型参数是QTimeZone::UTC或QTimeZone::LocalTime。UTC不需要从本地文件系统API返回的时间进行任何转换，因此获取UTC的时间可能更快。通常选择LocalTime以将时间显示给用户。

如果index无效，则返回默认构造的QDateTime。

此函数是在Qt 6.6中引入的。

[重载虚拟] QMimeData *QFileSystemModel::mimeData(const QModelIndexList &indexes) const

重新实现：QAbstractItemModel::mimeData(const QModelIndexList &indexes) const.

返回一个对象，其中包含指定的indexes的序列化描述。用于描述与indexes相关项的格式由mimeTypes()函数获得。

如果indexes的列表为空，则返回nullptr而不是序列化的空列表。

[重载虚拟] QStringList QFileSystemModel::mimeTypes() const

重新实现：QAbstractItemModel::mimeTypes() const.

返回可以用于描述模型中项目列表的MIME类型列表。

QModelIndex QFileSystemModel::mkdir(const QModelIndex &parent, const QString &name)

在父模型索引parent中创建名为name的目录。

QVariant QFileSystemModel::myComputer(int role = Qt::DisplayRole) const

返回为项目"My Computer"存储的给定role的数据。

另请参阅：Qt::ItemDataRole。

QStringList QFileSystemModel::nameFilters() const

返回应用于模型中名称的过滤器的列表。

另请参阅：setNameFilters。

[重载虚拟] QModelIndex QFileSystemModel::parent(const QModelIndex &index) const

重新实现: QAbstractItemModel::parent(const QModelIndex &index) const.

QFileDevice::Permissions QFileSystemModel::permissions(const QModelIndex &index) const

返回与index相对应的QFile::Permission的完整或组合。

bool QFileSystemModel::remove(const QModelIndex &index)

从文件系统模型中删除模型项index，并从文件系统中删除相应的文件，如果成功返回true。如果项无法删除，则返回false。

另请参阅：rmdir()。

bool QFileSystemModel::rmdir(const QModelIndex &index)

从文件系统模型中删除与模型项index相对应的目录，并从文件系统中删除相应的目录，如果成功返回true。如果目录无法删除，则返回false。

另请参阅：remove()。

[重写虚拟] QHash<int, QByteArray> QFileSystemModel::roleNames() const

重新实现: QAbstractItemModel::roleNames() const.

QDir QFileSystemModel::rootDirectory() const

当前设置的目录

另请参阅：rootPath()。

QString QFileSystemModel::rootPath() const

当前设置的根路径

另请参阅：setRootPath() 和 rootDirectory()。

[信号] void QFileSystemModel::rootPathChanged(const QString &newPath)

每当根路径更改为newPath时，都会发出此信号。

[重写虚拟] int QFileSystemModel::rowCount(const QModelIndex &parent = QModelIndex()) const

重新实现: QAbstractItemModel::rowCount(const QModelIndex &parent) const.

[重写虚拟] bool QFileSystemModel::setData(const QModelIndex &idx, const QVariant &value, int role = Qt::EditRole)

重新实现: QAbstractItemModel::setData(const QModelIndex &index, const QVariant &value, int role).

另请参阅：data().

void QFileSystemModel::setFilter(QDir::Filters filters)

将目录模型的过滤器设置为指定的 filters。

请注意，您设置的过滤器应始终包括 QDir::AllDirs 枚举值，否则 QFileSystemModel 无法读取目录结构。

另请参阅 filter() 和 QDir::Filters。

void QFileSystemModel::setIconProvider(QAbstractFileIconProvider *provider)

为目录模型设置文件图标的 provider。

另请参阅 iconProvider。

void QFileSystemModel::setNameFilters(const QStringList &filters)

设置应用现有文件上的名称 filters。

另请参阅 nameFilters。

void QFileSystemModel::setOption(QFileSystemModel::Option option, bool on = true)

如果 on 为 true，则设置给定的 option 为启用状态；否则，清除指定的 option。

应在更改属性之前设置选项。

另请参阅 options 和 testOption。

QModelIndex QFileSystemModel::setRootPath(const QString &newPath)

通过在该路径上安装一个 文件系统监视器 来设置模型正在监视的目录为 newPath。此目录内的文件和目录的任何更改都会反映在模型中。

如果路径已更改，则将发出 rootPathChanged() 信号。

另请参阅：rootPath()。

[覆盖虚拟] QModelIndex QFileSystemModel::sibling(int row, int column, const QModelIndex &idx) const

重新实现: QAbstractItemModel::sibling(int row, int column, const QModelIndex &index) const。

qint64 QFileSystemModel::size(const QModelIndex &index) const

返回 index 字节大小。如果文件不存在，则返回 0。

[覆盖虚拟] void QFileSystemModel::sort(int column, Qt::SortOrder order = Qt::AscendingOrder)

重新实现: QAbstractItemModel::sort(int column, Qt::SortOrder order)。

[重写虚函数] Qt::DropActions QFileSystemModel::supportedDropActions() const

重写: QAbstractItemModel::supportedDropActions() const.

bool QFileSystemModel::testOption(QFileSystemModel::Option option) const

如果指定的选项被启用，则返回真；否则返回假。

另请参阅 options 和 setOption().

[重写虚保护] void QFileSystemModel::timerEvent(QTimerEvent *event)

重写: QObject::timerEvent(QTimerEvent *event).

QString QFileSystemModel::type(const QModelIndex &index) const

返回文件index的类型，例如“目录”或“JPEG文件”。