Класс QRunnable

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

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

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

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

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

Класс 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.

[pure virtual] void QRunnable::run()

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

void QRunnable::setAutoDelete(bool autoDelete)

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

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

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

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