En esta página

Compatibilidad con subprocesos en los módulos de Qt

Hilos y el módulo SQL

Una conexión a la base de datos solo debe utilizarse desde el hilo que la creó. Para trasladar una conexión a otro hilo, se puede utilizar la función ` QSqlDatabase::moveToThread()`.

Además, las bibliotecas de terceros utilizadas por los QSqlDrivers pueden imponer restricciones adicionales al uso del módulo SQL en un programa multihilo. Consulta el manual de tu cliente de base de datos para obtener más información

Dibujar en subprocesos

QPainter Se puede utilizar en un hilo para dibujar en los dispositivos de dibujo QImage, QPrinter, QPicture y (para la mayoría de plataformas) QPixmap. No se admite el dibujo en QWidgets. En macOS, no se mostrará el cuadro de diálogo de progreso automático si se realiza la impresión desde fuera del hilo de la interfaz gráfica de usuario.

Cualquier número de subprocesos puede dibujar en un momento dado; sin embargo, solo un subproceso a la vez puede dibujar en un dispositivo de dibujo concreto. En otras palabras, dos subprocesos pueden dibujar al mismo tiempo si cada uno lo hace en QImages independientes, pero los dos subprocesos no pueden dibujar en el mismo QImage al mismo tiempo.

Hilos y procesamiento de texto enriquecido

QTextDocument, QTextCursor y todas las clases relacionadas son reentrantes.

Tenga en cuenta que una instancia de ` QTextDocument ` creada en el hilo de la interfaz gráfica de usuario puede contener recursos de imagen de ` QPixmap `. Utilice ` QTextDocument::clone()` para crear una copia del documento y pase la copia a otro hilo para su posterior procesamiento (como la impresión).

Los hilos y el módulo SVG

Las clases ` QSvgGenerator ` y ` QSvgRenderer ` del módulo ` QtSvg ` son reentrantes.

Hilos y clases compartidas implícitamente

Qt utiliza una optimización denominada «compartición implícita» para muchas de sus clases de valor, en particular QImage y QString. A partir de Qt 4, las clases con compartición implícita pueden copiarse de forma segura entre subprocesos, al igual que cualquier otra clase de valor. Son totalmente reentrantes. La compartición implícita es realmente implícita.

Para muchas personas, el uso compartido implícito y el multihilo son conceptos incompatibles, debido a la forma en que se suele llevar a cabo el recuento de referencias. Qt, sin embargo, utiliza el recuento atómico de referencias para garantizar la integridad de los datos compartidos, evitando así una posible corrupción del contador de referencias.

Ten en cuenta que el recuento atómico de referencias no garantiza la seguridad entre subprocesos. Se debe utilizar un bloqueo adecuado al compartir una instancia de una clase compartida implícitamente entre subprocesos. Este es el mismo requisito que se exige a todas las clases reentrantes, sean compartidas o no. No obstante, el recuento atómico de referencias sí garantiza que un hilo que trabaje con su propia instancia local de una clase compartida implícitamente sea seguro. Recomendamos utilizar señales y ranuras para pasar datos entre hilos, ya que esto puede hacerse sin necesidad de ningún bloqueo explícito.

En resumen, las clases compartidas implícitamente en Qt 4 son realmente compartidas de forma implícita. Incluso en aplicaciones multihilo, puedes utilizarlas con total seguridad como si fueran clases normales, no compartidas, reentrantes y basadas en valores.

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