En esta página

Tecnologías multihilo en Qt

Qt ofrece numerosas clases y funciones para trabajar con subprocesos. A continuación se presentan cuatro enfoques diferentes que los programadores de Qt pueden utilizar para implementar aplicaciones multihilo.

QThread: API de bajo nivel con bucles de eventos opcionales

QThread es la base de todo el control de subprocesos en Qt. Cada instancia de ` QThread ` representa y controla un subproceso.

QThread Se puede instanciar directamente o crear una subclase. Al instanciar un ` QThread ` se obtiene un bucle de eventos paralelo, lo que permite invocar las ranuras ` QObject ` en un hilo secundario. Crear una subclase de ` QThread ` permite a la aplicación inicializar el nuevo hilo antes de iniciar su bucle de eventos, o ejecutar código en paralelo sin un bucle de eventos.

Consulte los ejemplos de QThread class reference y de subprocesos para ver demostraciones sobre cómo utilizar QThread.

QThreadPool y QRunnable: reutilización de subprocesos

Crear y destruir hilos con frecuencia puede suponer un coste elevado. Para reducir esta sobrecarga, los hilos existentes pueden reutilizarse para nuevas tareas. QThreadPool es una colección de QThreads reutilizables.

Para ejecutar código en uno de los subprocesos de QThreadPool, reimplemente QRunnable::run() e instancie la subclase QRunnable. Utilice QThreadPool::start() para colocar el QRunnable en la cola de ejecución de QThreadPool. Cuando un subproceso esté disponible, el código dentro de QRunnable::run() se ejecutará en ese subproceso.

Cada aplicación Qt dispone de un grupo de subprocesos global, al que se puede acceder mediante QThreadPool::globalInstance(). Este grupo de subprocesos global mantiene automáticamente un número óptimo de subprocesos en función del número de núcleos de la CPU. No obstante, se puede crear y gestionar explícitamente un grupo de subprocesos independiente QThreadPool.

Qt Concurrent: Uso de una API de alto nivel

El Qt Concurrent módulo proporciona funciones de alto nivel que gestionan algunos patrones comunes de cálculo paralelo: map, filter y reduce. A diferencia de lo que ocurre al utilizar QThread y QRunnable, estas funciones nunca requieren el uso de primitivas de subprocesos de bajo nivel, como mutex o semáforos. En su lugar, devuelven un objeto ` QFuture `, que puede utilizarse para recuperar los resultados de las funciones cuando estén listos. ` QFuture ` también puede utilizarse para consultar el progreso del cálculo y para pausar, reanudar o cancelar el cálculo. Para mayor comodidad, ` QFutureWatcher ` permite la interacción con los ` QFuture` a través de señales y ranuras.

Qt ConcurrentLos algoritmos «map», «filter» y «reduce» distribuyen automáticamente el cálculo entre todos los núcleos de procesador disponibles, por lo que las aplicaciones escritas hoy seguirán escalando cuando se implementen más adelante en un sistema con más núcleos.

Este módulo también proporciona la función ` QtConcurrent::run()`, que puede ejecutar cualquier función en otro hilo. Sin embargo, ` QtConcurrent::run()` solo admite un subconjunto de las características disponibles para las funciones `map`, `filter` y `reduce`. La función ` QFuture ` se puede utilizar para recuperar el valor de retorno de la función y para comprobar si el hilo se está ejecutando. Sin embargo, una llamada a ` QtConcurrent::run()` utiliza un solo hilo, no se puede pausar, reanudar ni cancelar, y no es posible consultar su progreso.

Consulte la Qt Concurrent documentación del módulo para obtener más detalles sobre las funciones individuales.

WorkerScript: subprocesos en QML

El tipo QML ` WorkerScript ` permite que el código JavaScript se ejecute en paralelo con el hilo de la interfaz gráfica de usuario.

Cada instancia de ` WorkerScript ` puede tener asociado un script ` .js `. Cuando se llama a ` WorkerScript.sendMessage()`, el script se ejecutará en un hilo independiente (y en un ` QML context` independiente). Cuando el script termine de ejecutarse, puede enviar una respuesta al hilo de la interfaz gráfica de usuario, lo que invocará el manejador de señales ` WorkerScript.onMessage()`.

El uso de un « WorkerScript » es similar al de un «worker» QObject que se ha trasladado a otro hilo. Los datos se transfieren entre hilos mediante señales.

Consulte la documentación de WorkerScript para obtener más detalles sobre cómo implementar el script y para ver una lista de los tipos de datos que se pueden pasar entre subprocesos.

Elección del enfoque adecuado

Como se ha demostrado anteriormente, Qt ofrece diferentes soluciones para desarrollar aplicaciones con subprocesos. La solución adecuada para una aplicación determinada depende de la finalidad del nuevo subproceso y de su tiempo de vida. A continuación se presenta una comparación de las tecnologías de subprocesos de Qt, seguida de soluciones recomendadas para algunos casos de uso de ejemplo.

Comparación de soluciones

CaracterísticaQThreadQRunnable y QThreadPoolQtConcurrent::run()Qt Concurrent (Map, Filter, Reduce)WorkerScript
LenguajeC++C++C++C++QML
Se puede especificar la prioridad del hiloSíSí
El hilo puede ejecutar un bucle de eventosSí
El hilo puede recibir actualizaciones de datos a través de señalesSí (recibidas por un « QObject » de trabajo)Sí (recibidas por WorkerScript)
El hilo se puede controlar mediante señalesSí (recibidas por QThread)Sí (recibidas por QFutureWatcher)
El hilo se puede supervisar a través de un QFutureParcialmenteSí
Funcionalidad integrada para pausar/reanudar/cancelarSí

Ejemplos de casos de uso

Duración del hiloOperaciónSolución
Una llamadaEjecutar una nueva función lineal en otro hilo, opcionalmente con actualizaciones de progreso durante la ejecución.Qt ofrece diferentes soluciones:
Una llamadaEjecuta una función existente en otro hilo y obtén su valor de retorno.Ejecuta la función utilizando QtConcurrent::run(). Haz que un QFutureWatcher emita la señal finished() cuando la función haya finalizado y llama a QFutureWatcher::result() para obtener el valor de retorno de la función.
Una llamadaRealiza una operación sobre todos los elementos de un contenedor, utilizando todos los núcleos disponibles. Por ejemplo, generar miniaturas a partir de una lista de imágenes.Utiliza la función ` QtConcurrent::filter()` de ` Qt Concurrent` para seleccionar los elementos del contenedor, y la función ` QtConcurrent::map()` para aplicar una operación a cada elemento. Para agrupar la salida en un único resultado, utiliza en su lugar ` QtConcurrent::filteredReduced()` y ` QtConcurrent::mappedReduced()`.
Una llamada/PermanenteRealiza un cálculo largo en una aplicación QML pura y actualiza la interfaz gráfica de usuario cuando los resultados estén listos.Coloca el código de cálculo en un script ` .js ` y adjúntalo a una instancia de ` WorkerScript `. Llama a ` WorkerScript.sendMessage()` para iniciar el cálculo en un nuevo hilo. Haz que el script llame también a `sendMessage()` para devolver el resultado al hilo de la interfaz gráfica de usuario. Gestiona el resultado en ` onMessage ` y actualiza allí la interfaz gráfica de usuario.
PermanenteDispón de un objeto que resida en otro hilo y que pueda realizar diferentes tareas cuando se le solicite y/o pueda recibir nuevos datos con los que trabajar.Crea una subclase de ` QObject ` para crear un «trabajador». Instancia este objeto «trabajador» y un ` QThread`. Mueve el «trabajador» al nuevo hilo. Envía comandos o datos al objeto «trabajador» a través de conexiones de señal-ranura en cola.
PermanenteRealiza repetidamente una operación costosa en otro hilo, en el que el hilo no necesita recibir ninguna señal ni evento.Escribe el bucle infinito directamente dentro de una reimplementación de ` QThread::run()`. Inicia el hilo sin un bucle de eventos. Deja que el hilo emita señales para enviar datos de vuelta al hilo de la interfaz gráfica de usuario.

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