QFileSystemModel Class

成员函数文档

[explicit] QFileSystemModel::QFileSystemModel(QObject *parent = nullptr)

用给定的parent 构建文件系统模型。

[virtual noexcept] QFileSystemModel::~QFileSystemModel()

销毁该文件系统模型。

[override virtual] bool QFileSystemModel::canFetchMore(const QModelIndex &parent) const

重实现：QAbstractItemModel::canFetchMore(const QModelIndex &parent) const.

[override virtual] int QFileSystemModel::columnCount(const QModelIndex &parent = QModelIndex()) const

重实现：QAbstractItemModel::columnCount(const QModelIndex &parent) const.

[override virtual] QVariant QFileSystemModel::data(const QModelIndex &index, int role = Qt::DisplayRole) const

重实现：QAbstractItemModel::data(const QModelIndex &index, int role) const.

另请参阅 setData().

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

当收集器线程完成加载path 时，会发出该信号。

[override virtual] 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().

[override virtual protected] bool QFileSystemModel::event(QEvent *event)

重实现：QObject::event(QEvent *e)。

[override virtual] 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 ，返回存储在模型中的项目的路径。

[signal] 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 。

[override virtual] Qt::ItemFlags QFileSystemModel::flags(const QModelIndex &index) const

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

[override virtual] bool QFileSystemModel::hasChildren(const QModelIndex &parent = QModelIndex()) const

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

[override virtual] 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()。

[override virtual] 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 。

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

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

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

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

此函数在 Qt 6.6 中引入。

[override virtual] QMimeData *QFileSystemModel::mimeData(const QModelIndexList &indexes) const

重实现：QAbstractItemModel::mimeData(const QModelIndexList &indexes) 常量。

返回一个包含指定indexes 序列化描述的对象。用于描述索引对应项的格式可从mimeTypes() 函数中获取。

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

[override virtual] QStringList QFileSystemModel::mimeTypes() const

重实现：QAbstractItemModel::mimeTypes() 常量。

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

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

在parent 模型索引中创建name 目录。

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

返回存储在给定role 下的 "我的电脑 "项目的数据。

另请参阅 Qt::ItemDataRole 。

QStringList QFileSystemModel::nameFilters() const

返回应用于模型中名称的筛选器列表。

另请参阅 setNameFilters()。

[override virtual] QModelIndex QFileSystemModel::parent(const QModelIndex &index) const

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

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

返回index 的 QFile::Permission 的完整 OR-ed together 组合。

bool QFileSystemModel::remove(const QModelIndex &index)

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

另请参见 rmdir()。

bool QFileSystemModel::rmdir(const QModelIndex &index)

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

另请参见 remove()。

[override virtual] QHash<int, QByteArray> QFileSystemModel::roleNames() const

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

QDir QFileSystemModel::rootDirectory() const

当前设置的目录

另请参见 rootPath()。

QString QFileSystemModel::rootPath() const

当前设置的根路径

另请参见 setRootPath() 和rootDirectory()。

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

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

[override virtual] int QFileSystemModel::rowCount(const QModelIndex &parent = QModelIndex()) const

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

[override virtual] 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)

通过安装file system watcher ，将模型正在监视的目录设置为newPath 。该目录中文件和目录的任何更改都会反映在模型中。

如果路径发生变化，将发出rootPathChanged() 信号。

另请参阅 rootPath(),QTreeView::setRootIndex() 和TreeView::rootIndex 。

[override virtual] 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。

[override virtual] void QFileSystemModel::sort(int column, Qt::SortOrder order = Qt::AscendingOrder)

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

[override virtual] Qt::DropActions QFileSystemModel::supportedDropActions() const

重实现：QAbstractItemModel::supportedDropActions() const.

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

如果给定的option 已启用，则返回true ；否则返回 false。

另请参阅 options 和setOption()。

[override virtual protected] void QFileSystemModel::timerEvent(QTimerEvent *event)

重实现：QObject::timerEvent(QTimerEvent *event).

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

返回文件类型index ，如 "目录 "或 "JPEG 文件"。