En esta página

Ejemplo de «Fetch More»

El ejemplo «Fetch More» muestra cómo añadir elementos a un modelo de vista de elementos bajo demanda.

Aplicación que recupera y añade más elementos al modelo de vista

Cuando se dispone de conjuntos de datos grandes —o quizá incluso infinitos—, será necesario añadir elementos al modelo por lotes y, preferiblemente, solo cuando la vista los necesite (es decir, cuando se hagan visibles en la vista).

En este ejemplo, implementamos « FileListModel », un modelo de vista de elementos que contiene las entradas de un directorio. También contamos con « Window », que configura la interfaz gráfica de usuario y alimenta el modelo con directorios.

La interfaz de usuario consiste en un cuadro de diálogo con una lista que muestra el contenido del directorio raíz. Se puede navegar por los directorios haciendo doble clic.

En la parte inferior, hay una ventana de registro que muestra mensajes cuando la vista solicita más datos al modelo.

Para probarlo, ve a un directorio grande (por ejemplo, /bin) y desplázate hasta la parte inferior. Aparecerán mensajes de registro que muestran los datos que se están recuperando.

Echemos un vistazo al código de FileListModel.

Definición de la clase FileListModel

FileListModel hereda de QAbstractListModel y contiene el contenido de un directorio. Solo añadirá elementos a sí misma cuando la vista se lo solicite.

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;
};

El secreto reside en la reimplementación de ` fetchMore()` y ` canFetchMore()` de ` QAbstractItemModel`. La vista de elementos llama a estas funciones cuando necesita más elementos.

La función setDirPath() establece el directorio con el que trabajará el modelo. Emitimos numberPopulated() cada vez que añadimos un lote de elementos al modelo.

Guardamos todas las entradas del directorio en fileList. fileCount es el número de elementos que se han añadido al modelo.

Implementación de la clase `FileListModel`

Empezamos por obtener el contenido de 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();
}

Utilizamos un objeto ` QDir ` para obtener el contenido del directorio. Debemos indicar a ` QAbstractItemModel ` que queremos eliminar todos los elementos —si los hay— del modelo.

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

La vista llama a la función ` canFetchMore() ` cuando necesita más elementos. Devolvemos `true` si aún hay entradas que no hayamos añadido al modelo; en caso contrario, devolvemos `false`.

Y ahora, la propia función ` 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()));
}

Primero calculamos el número de elementos que hay que recuperar. beginInsertRows() y endInsertRows() son obligatorios para que QAbstractItemModel pueda seguir el ritmo de las inserciones de filas. Por último, emitimos numberPopulated(), que es recogido por Window.

Para completar el recorrido, también echamos un vistazo a rowCount() y 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 {};
}

Obsérvese que el recuento de filas corresponde únicamente a los elementos que hemos añadido hasta ahora, es decir, no al número de entradas del directorio.

En data(), devolvemos la entrada correspondiente de fileList. También separamos los lotes con un color de fondo diferente.

Proyecto de ejemplo en @ code.qt.io

© 2026 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.