QtTaskTree::QProcessTaskDeleter Class
class QtTaskTree::QProcessTaskDeleterUn programa de eliminación personalizado para QProcess, utilizado por QProcessTask. Más...
| Encabezado: | #include <qprocesstask.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS TaskTree) target_link_libraries(mytarget PRIVATE Qt6::TaskTree) |
| qmake: | QT += tasktree |
| Desde: | Qt 6.11 |
| Estado: | Versión preliminar |
Esta clase se encuentra en fase de vista previa tecnológica y está sujeta a cambios.
Nota: Todas las funciones de esta clase son reentrantes.
Funciones públicas
| void | operator()(QProcess *process) const |
Miembros públicos estáticos
| void | syncAll() |
Descripción detallada
QProcessTaskDeleter se utiliza para permitir la destrucción rápida de instancias de QProcess en ejecución a través de QProcessTask en QTaskTree. En lugar de eliminar la QProcess en ejecución, lo que podría bloquear la ejecución del hilo del llamante durante mucho tiempo, QProcessTaskDeleter traslada la QProcess en ejecución a un hilo independiente e intenta finalizarla de la forma más suave posible. Esto consiste en llamar a ` QProcess::terminate()` con un tiempo de espera de ` 500 ms `, y si el proceso sigue en ejecución una vez transcurrido dicho tiempo de espera, se realiza una llamada adicional a ` QProcess::kill()`.
Por último, al cerrar la aplicación, se debe llamar a ` QProcessTaskDeleter::syncAll()` para sincronizar todos los procesos que aún puedan estar finalizándose en un hilo independiente. La llamada a ` QProcessTaskDeleter::syncAll()` es bloqueante en caso de que algunos procesos aún se estén finalizando.
Esta estrategia parece razonable, ya que al eliminar el QProcess en ejecución mediante QProcessTaskDeleter no se bloquea inmediatamente, sino que se pospone el posible (aunque no seguro) bloqueo hasta el final de la aplicación.
La utiliza QProcessTask.
Documentación de la función miembro
[static] void QProcessTaskDeleter::syncAll()
Este método debe invocarse al cerrar la aplicación para sincronizar la finalización de todas las instancias de ` QProcess ` que aún puedan estar en ejecución y que se hayan eliminado antes de utilizar ` QProcessTaskDeleter`. La llamada debe ejecutarse desde el hilo principal.
void QProcessTaskDeleter::operator()(QProcess *process) const
Elimina el objeto ` process ` pasado de la forma más segura posible. Si el objeto ` process ` pasado no se está ejecutando, se elimina directamente. En caso contrario, traslada el objeto ` process ` a un hilo independiente e intenta finalizarlo de la forma más segura posible llamando a ` QProcess::terminate()` con un tiempo de espera de ` 500 ms `; si el proceso sigue en ejecución una vez transcurrido este tiempo de espera, se realiza una llamada adicional a ` QProcess::kill()`.
© 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.