En esta página

Modelos y vistas: Modelo de lista que utiliza un hilo de trabajo para la obtención de datos

Muestra cómo implementar un modelo de lista con una interfaz de usuario receptiva utilizando un hilo de trabajo para recuperar datos.

Captura de pantalla de la aplicación en la que se puede ver una lista de canciones con carátulas de álbumes, títulos de canciones, nombres de artistas y títulos de álbumes

Este ejemplo presenta un modelo de elemento personalizado que hereda de ` QAbstractListModel`. El modelo obtiene sus datos de un objeto de trabajo que se encuentra en un ` QThread` independiente, que a su vez recupera datos de una fuente de datos lenta.

Descripción general del ejemplo «Lista de canciones con subprocesos»

La fuente de datos simula una fuente de datos lenta añadiendo un retraso de 100 milisegundos por cada canción que se recupera de ella. Esto significa que la carga de la lista completa de 3.600 canciones tardaría 6 minutos, lo que haría que la apertura de la aplicación resultara poco práctica. Este retraso se mitiga recuperando solo los datos correspondientes al área visible de la vista, mediante un objeto « QObject » situado en un hilo de trabajo.

El objeto de trabajo tiene un límite en el número de solicitudes de recuperación que mantiene en cola. Esto garantiza que solo se recuperen los elementos de la parte actualmente visible de la lista de canciones, eliminando la necesidad de esperar a que se cargue la parte no visible de la lista cuando el usuario ya se ha desplazado más allá de cierta parte de la misma.

Este ejemplo se centra en el modelo de origen de la vista. La vista en sí es un « ListView » de QML sin modificar, con un delegado sencillo. El uso del hilo queda oculto tras la implementación del manejo de datos del modelo, y el « ListView » no necesita ninguna personalización para adaptarse al modelo basado en hilos.

Además, dado que el enfoque está en el modelo, los controles de Qt Quick están configurados para utilizar el estilo «Universal» en todas las plataformas, con el fin de garantizar un comportamiento idéntico de la interfaz de usuario.

import QtQuick
import QtQuick.Controls.Universal

Cómo funciona

La lógica de negocio encargada de proporcionar los datos de la lista de canciones se ha separado en una clase « DataStorage », que ofrece una interfaz sencilla basada en identificadores para el modelo.

QList<int> idList();
MediaElement item(int id) const;
std::optional<int> currentlyFetchedId() const;

Cuando el modelo solicita datos al «DataStorage», este comprueba primero si ya dispone de los datos. Si es así, los datos se devuelven al instante, tal y como ocurriría en un modelo sin subprocesos. En caso de que no se encuentren los datos, «DataStorage» emitirá una señal « dataFetchNeeded() » al objeto «worker» y añadirá un elemento vacío a la lista de datos ya existentes. La incorporación del elemento vacío garantiza que no se envíen más señales al trabajador para el mismo elemento de la lista.

if (!m_items.contains(id)) {
    m_items.insert(id, MediaElement{});
    emit dataFetchNeeded(m_idList.indexOf(id));
}
return m_items.value(id);

QueueWorker - El objeto de hilo de trabajo procesa las señales `dataFetchNeeded()` que ha recibido enviándose una señal a sí mismo, lo que permite recibir todas las señales que ya se encuentran en `QEventQueue` antes de iniciar la operación de lectura lenta de datos.

Aplicación del enfoque a modelos dinámicos

Si se desea ampliar la solución a un caso en el que se puedan añadir, mover o eliminar elementos de la fuente de datos (en este caso, RemoteMedia), es necesario actualizar DataStorage con señales que se correspondan con ` QAbstractItemModel::rowsMoved()`, ` QAbstractItemModel::rowsInserted()` y dos señales para activar ` QAbstractItemModel::beginRemoveRows()` y ` QAbstractItemModel::endRemoveRows()` dentro de `ThreadedListModel`.

Para la inserción y el desplazamiento, ThreadedListModel solo tiene que llamar a QAbstractItemModel::beginInsertRows(), añadir los nuevos ID a su lista de ID y llamar a QAbstractItemModel::endInsertRows(). Dado que ThreadedListModel mantiene una copia de la lista de ID y accede al almacenamiento por ID, no es necesario señalar el inicio y el final del almacenamiento. Del mismo modo, ThreadedListModel puede llamar a QAbstractItemModel::beginMoveRows(), mover los ID en su lista de ID y, a continuación, llamar a QAbstractItemModel::endMoveRows().

La eliminación es un caso ligeramente más complejo. La vista debe tener la posibilidad de solicitar los datos que se van a eliminar antes de que se eliminen realmente. Por lo tanto, DataStorage debe enviar una advertencia de la eliminación, lo que hace que el modelo llame a QAbstractItemModel::beginRemoveRows(). En esta fase, ThreadedListModel puede recibir una o varias llamadas a « data() ». Una vez que la llamada a la señal «direct connected» regresa a DataStorage, este puede eliminar el elemento y, a continuación, enviar de nuevo una señal al modelo con otra señal que haga que este llame a « QAbstractItemModel::endRemoveRows()».

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

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.