Класс QRunnable

Класс QRunnable — базовый класс для всех выполняемых объектов. Подробнее...

Этот класс был представлен в Qt 4.4.

• Список всех членов, включая унаследованные

Открытые функции

Статические открытые члены

Подробное описание

Класс QRunnable — интерфейс для представления задачи или фрагмента кода, который нужно выполнить, реализованный в вашем переопределении функции run().

Вы можете использовать QThreadPool для выполнения кода в отдельном потоке. QThreadPool автоматически удаляет QRunnable, если autoDelete() возвращает true (по умолчанию). Используйте setAutoDelete(), чтобы изменить флаг автоматического удаления.

QThreadPool поддерживает выполнение одной и той же QRunnable более одного раза, вызывая QThreadPool::tryStart(this) внутри функции run(). Если autoDelete включен, QRunnable будет удалён, когда последний поток завершит функцию run. Вызов QThreadPool::start() несколько раз с одним и тем же QRunnable, когда autoDelete включен, создаёт гонку и не рекомендуется.

См. также QThreadPool.

Документация по функциям-членам

QRunnable::QRunnable()

Конструирует QRunnable. Автоматическое удаление включено по умолчанию.

См. также autoDelete() и setAutoDelete().

[virtual] QRunnable::~QRunnable()

Виртуальный деструктор QRunnable.

bool QRunnable::autoDelete() const

Возвращает true, если автоматическое удаление включено; в противном случае — false.

Если автоматическое удаление включено, QThreadPool автоматически удалит этот выполнимый объект после вызова run(); в противном случае владение остаётся за программистом приложения.

См. также setAutoDelete() и QThreadPool.

[static] QRunnable *QRunnable::create(std::function<void ()> functionToRun)

Создаёт QRunnable, который вызывает functionToRun в run().

Автоматическое удаление включено по умолчанию.

Эта функция была представлена в Qt 5.15.

См. также run() и autoDelete().

[pure virtual] void QRunnable::run()

Реализуйте эту чисто виртуальную функцию в своём подклассе.

void QRunnable::setAutoDelete(bool autoDelete)

Включает автоматическое удаление, если autoDelete равно true; в противном случае автоматическое удаление отключено.

Если автоматическое удаление включено, QThreadPool автоматически удалит этот выполнимый объект после вызова run(); в противном случае владение остаётся за программистом приложения.

Обратите внимание, что этот флаг должен быть установлен до вызова QThreadPool::start(). Вызов этой функции после QThreadPool::start() приведёт к неопределённому поведению.

См. также autoDelete() и QThreadPool.