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

[pure virtual] void QRunnable::run()

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

void QRunnable::setAutoDelete(bool autoDelete)

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

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

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

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