En esta página

QRunnable Class

La clase QRunnable es la clase base de todos los objetos ejecutables. Más información...

Encabezado: #include <QRunnable>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Funciones públicas

QRunnable()
virtual ~QRunnable()
bool autoDelete() const
virtual void run() = 0
void setAutoDelete(bool autoDelete)

Miembros públicos estáticos

QRunnable *create(Callable &&callableToRun)

Descripción detallada

La clase QRunnable es una interfaz que representa una tarea o un fragmento de código que debe ejecutarse, representado por su reimplementación de la función run().

Puede utilizar ` QThreadPool ` para ejecutar su código en un hilo independiente. ` QThreadPool ` elimina automáticamente el `QRunnable` si ` autoDelete()` devuelve ` true ` (el valor por defecto). Utilice ` setAutoDelete()` para cambiar el indicador de eliminación automática.

QThreadPool Permite ejecutar el mismo QRunnable más de una vez llamando a QThreadPool::tryStart(this) desde dentro de la función run(). Si autoDelete está habilitado, el QRunnable se eliminará cuando el último hilo salga de la función run. Llamar a QThreadPool::start() varias veces con el mismo QRunnable cuando autoDelete está habilitado crea una condición de carrera y no se recomienda.

Véase también QThreadPool.

Documentación de las funciones de miembro

[constexpr noexcept default] QRunnable::QRunnable()

Crea un objeto QRunnable. La eliminación automática está activada por defecto.

Véase también autoDelete() y setAutoDelete().

[virtual noexcept] QRunnable::~QRunnable()

QRunnable destructor virtual.

bool QRunnable::autoDelete() const

Devuelve ` true ` si la eliminación automática está activada; en caso contrario, devuelve `false`.

Si la eliminación automática está activada, QThreadPool eliminará automáticamente este objeto ejecutable tras llamar a run(); en caso contrario, la propiedad seguirá recayendo en el programador de la aplicación.

Véase también setAutoDelete() y QThreadPool.

[static] template <typename Callable> requires if_callable<Callable> QRunnable *QRunnable::create(Callable &&callableToRun)

Crea un objeto ` QRunnable ` que llama a ` callableToRun ` en ` run()`.

La eliminación automática está habilitada de forma predeterminada.

Nota: En las versiones de Qt anteriores a la 6.6, este método solo admitía funciones copiables.

Restricciones

Participa en la resolución de sobrecargas solo si ` Callable ` es una función u objeto de función que se pueda invocar sin argumentos.

Véase también run() y autoDelete().

[pure virtual] void QRunnable::run()

Implementa esta función virtual pura en tu subclase.

void QRunnable::setAutoDelete(bool autoDelete)

Activa la eliminación automática si autoDelete es «true»; en caso contrario, la eliminación automática queda desactivada.

Si la eliminación automática está habilitada, QThreadPool eliminará automáticamente este objeto ejecutable tras llamar a run(); en caso contrario, la propiedad seguirá recayendo en el programador de la aplicación.

Ten en cuenta que este indicador debe establecerse antes de llamar a QThreadPool::start(). Llamar a esta función después de QThreadPool::start() da lugar a un comportamiento indefinido.

Véase también autoDelete() y QThreadPool.

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