Hilos y QObjects
QThread hereda de ` QObject`. Emite señales para indicar que el hilo ha comenzado o finalizado su ejecución, y también proporciona algunas ranuras.
Lo más interesante es que los objetos de tipo ` QObject` pueden utilizarse en varios subprocesos, emitir señales que invocan ranuras en otros subprocesos y enviar eventos a objetos que «residen» en otros subprocesos. Esto es posible porque cada subproceso puede tener su propio bucle de eventos.
Reentrancia de QObject
QObject es reentrante. La mayoría de sus subclases que no pertenecen a la interfaz gráfica de usuario (GUI), como QTimer, QTcpSocket, QUdpSocket y QProcess, también son reentrantes, lo que permite utilizar estas clases desde varios subprocesos simultáneamente. Ten en cuenta que estas clases están diseñadas para crearse y utilizarse desde un único hilo; no se garantiza que funcione crear un objeto en un hilo y llamar a sus funciones desde otro hilo. Hay tres restricciones que debes tener en cuenta:
- El objeto hijo de un ` QObject ` debe crearse siempre en el hilo en el que se creó el objeto padre. Esto implica, entre otras cosas, que nunca se debe pasar el objeto ` QThread ` (
this) como padre de un objeto creado en ese hilo (ya que el propio objeto ` QThread ` se creó en otro hilo). - Los objetos controlados por eventos solo pueden utilizarse en un único hilo. En concreto, esto se aplica al mecanismo de temporizador y a network module. Por ejemplo, no se puede iniciar un temporizador ni conectar un socket en un hilo que no sea el object's thread.
- Debes asegurarte de que todos los objetos creados en un hilo se eliminen antes de eliminar el ` QThread`. Esto se puede hacer fácilmente creando los objetos en la pila en tu implementación de ` run()`.
Aunque ` QObject ` es reentrante, las clases de la interfaz gráfica de usuario (GUI), en particular ` QWidget ` y todas sus subclases, no lo son. Solo pueden utilizarse desde el hilo principal. Como se ha señalado anteriormente, ` QCoreApplication::exec()` también debe llamarse desde ese hilo.
En la práctica, la imposibilidad de utilizar clases de interfaz gráfica de usuario en hilos distintos del hilo principal se puede solucionar fácilmente colocando las operaciones que requieren mucho tiempo en un hilo de trabajo independiente y mostrando los resultados en pantalla en el hilo principal cuando el hilo de trabajo haya finalizado. Este es el enfoque utilizado para implementar el ejemplo de Mandelbrot y el ejemplo de Blocking Fortune Client.
En general, no se admite la creación de QObjects antes del « QApplication » y puede provocar fallos extraños al salir, dependiendo de la plataforma. Esto significa que tampoco se admiten las instancias estáticas de QObject. Una aplicación de uno o varios subprocesos correctamente estructurada debería hacer que el « QApplication » sea el primero en crearse y el último en destruirse QObject.
Bucle de eventos por hilo
Cada hilo puede tener su propio bucle de eventos. El hilo inicial inicia su bucle de eventos mediante QCoreApplication::exec(), o, en el caso de aplicaciones GUI con un único cuadro de diálogo, a veces mediante QDialog::exec(). Otros hilos pueden iniciar un bucle de eventos mediante QThread::exec(). Al igual que QCoreApplication, QThread proporciona una función exit(int) y una ranura quit().
Un bucle de eventos en un hilo permite que este utilice determinadas clases de Qt que no pertenecen a la interfaz gráfica de usuario y que requieren la presencia de un bucle de eventos (como QTimer, QTcpSocket y QProcess). También permite conectar señales de cualquier hilo a las ranuras de un hilo específico. Esto se explica con más detalle en la sección «Señales y ranuras entre hilos» que figura a continuación.

Se dice que una instancia de QObject reside en el hilo en el que se crea. Los eventos dirigidos a ese objeto son distribuidos por el bucle de eventos de ese hilo. El hilo en el que reside un QObject se puede obtener mediante QObject::thread().
La función ` QObject::moveToThread()` cambia la afinidad de hilo de un objeto y de sus hijos (el objeto no se puede mover si tiene un padre).
Llamar a delete sobre un objeto QObject desde un hilo distinto al que es propietario del objeto (o acceder al objeto de otras formas) no es seguro, a menos que se garantice que el objeto no está procesando eventos en ese momento. Utiliza en su lugar ` QObject::deleteLater()` y se publicará un evento ` DeferredDelete `, que el bucle de eventos del hilo del objeto acabará detectando. Por defecto, el hilo propietario de un ` QObject ` es el hilo que crea el ` QObject`, pero no después de que se haya llamado a ` QObject::moveToThread()`.
Si no hay ningún bucle de eventos en ejecución, los eventos no se entregarán al objeto. Por ejemplo, si se crea un objeto ` QTimer ` en un hilo pero nunca se llama a ` exec()`, el ` QTimer ` nunca emitirá su señal ` timeout()`. Llamar a ` deleteLater()` tampoco funcionará. (Estas restricciones se aplican también al hilo principal).
Puedes enviar eventos manualmente a cualquier objeto en cualquier hilo y en cualquier momento utilizando la función segura para hilos QCoreApplication::postEvent(). Los eventos serán distribuidos automáticamente por el bucle de eventos del hilo en el que se creó el objeto.
Los filtros de eventos son compatibles en todos los hilos, con la restricción de que el objeto de supervisión debe residir en el mismo hilo que el objeto supervisado. Del mismo modo, ` QCoreApplication::sendEvent()` (a diferencia de ` postEvent()`) solo puede utilizarse para distribuir eventos a objetos que residan en el hilo desde el que se invoca la función.
Acceso a subclases de QObject desde otros subprocesos
QObject y todas sus subclases no son seguras para subprocesos. Esto incluye todo el sistema de entrega de eventos. Es importante tener en cuenta que el bucle de eventos puede estar entregando eventos a su subclase de ` QObject ` mientras usted accede al objeto desde otro subproceso.
Si llamas a una función de una subclase de ` QObject ` que no reside en el hilo actual y el objeto podría recibir eventos, debes proteger todo acceso a los datos internos de tu subclase de ` QObject ` con un mutex; de lo contrario, podrías sufrir fallos del sistema u otros comportamientos no deseados.
Al igual que otros objetos, los objetos de ` QThread ` residen en el hilo en el que se crearon,no en el hilo que se crea al llamar a ` QThread::run()`. Por lo general, no es seguro proporcionar ranuras en la subclase de ` QThread `, a menos que se protejan las variables miembro con un mutex.
Por otro lado, puede emitir señales de forma segura desde su implementación de ` QThread::run()`, ya que la emisión de señales es segura entre subprocesos.
Señales y ranuras entre subprocesos
Qt admite los siguientes tipos de conexión de señales y ranuras:
- Auto Connection (por defecto) Si la señal se emite en el hilo al que el objeto receptor tiene afinidad, el comportamiento es el mismo que el de la conexión directa. De lo contrario, el comportamiento es el mismo que el de la conexión en cola.
- Direct Connection La ranura se invoca inmediatamente, cuando se emite la señal. La ranura se ejecuta en el hilo del emisor, que no tiene por qué ser necesariamente el hilo del receptor.
- Queued Connection La ranura se invoca cuando el control vuelve al bucle de eventos del hilo del receptor. La ranura se ejecuta en el hilo del receptor.
- Blocking Queued Connection La ranura se invoca igual que en la «Conexión en cola», salvo que el hilo actual se bloquea hasta que la ranura devuelve un resultado.
Nota: El uso de este tipo para conectar objetos en el mismo hilo provocará un interbloqueo.
- Unique Connection El comportamiento es el mismo que el de la «Conexión automática», pero la conexión solo se establece si no duplica una conexión existente. Es decir, si la misma señal ya está conectada a la misma ranura para el mismo par de objetos, entonces no se establece la conexión y connect() devuelve «
false».
El tipo de conexión se puede especificar pasando un argumento adicional a ` connect()`. Ten en cuenta que el uso de conexiones directas cuando el emisor y el receptor residen en hilos diferentes no es seguro si se está ejecutando un bucle de eventos en el hilo del receptor, por la misma razón por la que no es seguro llamar a cualquier función de un objeto que resida en otro hilo.
QObject::connectLa función () en sí misma es segura para subprocesos.
El ejemplo de Mandelbrot utiliza una conexión en cola para la comunicación entre un hilo de trabajo y el hilo principal. Para evitar que se bloquee el bucle de eventos del hilo principal (y, en consecuencia, la interfaz de usuario de la aplicación), todo el cálculo del fractal de Mandelbrot se realiza en un hilo de trabajo independiente. El hilo emite una señal cuando termina de renderizar el fractal.
Del mismo modo, el ejemplo «Blocking Fortune Client» utiliza un hilo independiente para comunicarse de forma asíncrona con un servidor TCP.
© 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.