获取更多示例

Fetch More 示例展示了如何按需将项目添加到项目视图模型中。

当您拥有大型（甚至可能是无限大）数据集时，您需要分批向模型中添加项目，而且最好只在视图需要项目时（即项目在视图中可见时）才添加。

在本例中，我们实现了FileListModel --一个包含目录条目的条目视图模型。我们还有Window ，它负责设置图形用户界面并向模型提供目录。

用户界面包括一个显示根目录内容列表的对话框。双击即可浏览目录。

底部有一个日志窗口，显示视图要求模型提供更多数据时的信息。

要使用它，请导航到一个大的目录（如/bin ），然后滚动到底部。日志信息会显示正在检索的数据。

让我们浏览一下FileListModel 的代码。

FileListModel 类定义

FileListModel 继承于QAbstractListModel ，包含一个目录的内容。只有在视图要求时，它才会向自己添加项目。

class FileListModel : public QAbstractListModel
{
    Q_OBJECT

public:
    FileListModel(QObject *parent = nullptr);

    int rowCount(const QModelIndex &parent = QModelIndex()) const override;
    QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override;

    QFileInfo fileInfoAt(const QModelIndex &) const;

signals:
    void numberPopulated(const QString &path, int start, int number, int total);

public slots:
    void setDirPath(const QString &path);

protected:
    bool canFetchMore(const QModelIndex &parent) const override;
    void fetchMore(const QModelIndex &parent) override;

private:
    QFileInfoList fileList;
    QString path;
    QFileIconProvider iconProvider;
    int fileCount = 0;
};

其中的奥秘在于重新实现了QAbstractItemModel 中的fetchMore() 和canFetchMore() 函数。当项目视图需要更多项目时，就会调用这些函数。

setDirPath() 函数设置了模型工作的目录。每次向模型添加一批项目时，我们都会发射numberPopulated() 。

我们将所有目录条目保存在fileList 中。fileCount 是已添加到模型中的项目数。

FileListModel 类的实现

我们先从setDirPath() 开始。

void FileListModel::setDirPath(const QString &path)
{
    QDir dir(path);

    beginResetModel();
    this->path = path;
    fileList = dir.entryInfoList(QDir::NoDot | QDir::AllEntries, QDir::Name);
    fileCount = 0;
    endResetModel();
}

我们使用QDir 获取目录内容。我们需要告知QAbstractItemModel ，我们想从模型中删除所有项目（如果有的话）。

bool FileListModel::canFetchMore(const QModelIndex &parent) const
{
    if (parent.isValid())
        return false;
    return (fileCount < fileList.size());
}

当视图需要更多项目时，会调用canFetchMore() 函数。如果仍有未添加到模型中的条目，我们将返回 true；否则，我们将返回 false。

现在是fetchMore() 函数本身：

void FileListModel::fetchMore(const QModelIndex &parent)
{
    if (parent.isValid())
        return;
    const int start = fileCount;
    const int remainder = int(fileList.size()) - start;
    const int itemsToFetch = qMin(batchSize, remainder);

    if (itemsToFetch <= 0)
        return;

    beginInsertRows(QModelIndex(), start, start + itemsToFetch - 1);

    fileCount += itemsToFetch;

    endInsertRows();

    emit numberPopulated(path, start, itemsToFetch, int(fileList.size()));
}

我们首先计算要获取的条目的数量。beginInsertRows() 和endInsertRows() 对于QAbstractItemModel 来说是必须的，这样才能跟上行的插入。最后，我们发送numberPopulated() ，由Window 接收。

最后，我们还浏览了rowCount() 和data() 。

int FileListModel::rowCount(const QModelIndex &parent) const
{
    return parent.isValid() ? 0 : fileCount;
}

QVariant FileListModel::data(const QModelIndex &index, int role) const
{
    if (!index.isValid())
        return {};

    const int row = index.row();
    if (row >= fileList.size() || row < 0)
        return {};

    switch (role) {
    case Qt::DisplayRole:
        return fileList.at(row).fileName();
    case Qt::BackgroundRole: {
        const int batch = row / batchSize;
        const QPalette &palette = QGuiApplication::palette();
        return (batch % 2) != 0 ? palette.alternateBase() : palette.base();
    }
    case Qt::DecorationRole:
        return iconProvider.icon(fileList.at(row));
    }
    return {};
}

请注意，行计数只是我们迄今为止添加的条目，而不是目录中的条目数。

在data() 中，我们从fileList 返回相应的条目。我们还用不同的背景颜色分隔批次。

示例项目 @ code.qt.io

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.