Класс QEventLoop

Класс QEventLoop предоставляет возможность входить и выходить из цикла обработки событий. Подробнее...

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

Типы публичного доступа

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

Переопределённые открытые функции

Открытые слоты

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

В любое время вы можете создать объект QEventLoop и вызвать exec() на нём, чтобы запустить локальный цикл обработки событий. Внутри цикла обработки событий вызов exit() принудительно вернёт exec().

См. также QAbstractEventDispatcher.

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

Перечисление QEventLoop::ProcessEventsFlagФлаги QEventLoop::ProcessEventsFlags

Это перечисление управляет типами событий, обрабатываемых функциями processEvents().

Тип ProcessEventsFlags является псевдонимом для QFlags<ProcessEventsFlag>. Он хранит логическое ИЛИ сочетание значений ProcessEventsFlag.

См. также processEvents().

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

QEventLoop::QEventLoop(QObject *parent = nullptr)

Создаёт объект цикла обработки событий с заданным parent.

[slot] void QEventLoop::quit()

Указывает циклу обработки событий завершиться нормально.

То же самое, что и exit(0).

См. также QCoreApplication::quit() и exit().

[virtual] QEventLoop::~QEventLoop()

Уничтожает объект цикла обработки событий.

[override virtual] bool QEventLoop::event(QEvent *event)

Переопределяет: QObject::event(QEvent *e).

int QEventLoop::exec(QEventLoop::ProcessEventsFlags flags = ВсеСобытия)

Входит в основной цикл обработки событий и ожидает, пока не будет вызвано exit(). Возвращает значение, переданное в exit().

Если указаны flags, будут обрабатываться только события, соответствующие flags.

Необходимо вызвать эту функцию для запуска обработки событий. Основной цикл обработки событий получает события от системы окон и рассылает их виджетам приложения.

Как правило, никакого пользовательского взаимодействия не может произойти до вызова exec(). Как особый случай, модальные виджеты, такие как QMessageBox, могут быть использованы перед вызовом exec(), потому что модальные виджеты используют свой собственный локальный цикл обработки событий.

Для того, чтобы ваше приложение выполняло обработку в режиме ожидания (т.е. выполняло специальную функцию всякий раз, когда нет ожидающих событий), используйте QTimer с таймаутом 0. Более сложные схемы обработки в режиме ожидания могут быть реализованы с помощью processEvents().

См. также QCoreApplication::quit(), exit() и processEvents().

void QEventLoop::exit(int returnCode = 0)

Указывает циклу обработки событий завершиться с кодом возврата.

После того, как эта функция была вызвана, цикл обработки событий возвращается из вызова exec(). Функция exec() возвращает returnCode.

По соглашению, returnCode 0 означает успех, а любое ненулевое значение указывает на ошибку.

Обратите внимание, что в отличие от одноимённой функции библиотеки C, эта функция возвращается вызывающей стороне — останавливается обработка событий.

См. также QCoreApplication::quit(), quit() и exec().

bool QEventLoop::isRunning() const

Возвращает true если цикл обработки событий работает; в противном случае возвращает false. Цикл обработки событий считается работающим с момента вызова exec() до вызова exit().

См. также exec() и exit().

bool QEventLoop::processEvents(QEventLoop::ProcessEventsFlags flags = ВсеСобытия)

Обрабатывает некоторые ожидающие события, которые соответствуют flags. Возвращает true если ожидающие события были обработаны; в противном случае возвращает false.

Эта функция особенно полезна, если у вас есть длительная операция, и вы хотите показать её прогресс без разрешения пользовательского ввода; т.е. используя флаг ExcludeUserInputEvents.

Эта функция просто оборачивает QAbstractEventDispatcher::processEvents(). Смотрите документацию этой функции для получения подробностей.

void QEventLoop::processEvents(QEventLoop::ProcessEventsFlags flags, int maxTime)

Обрабатывает ожидающие события, соответствующие flags, в течение максимального времени maxTime миллисекунд или до тех пор, пока не останется больше событий для обработки, что произойдёт раньше.

Примечания:

• Эта функция не обрабатывает события непрерывно; она возвращается после обработки всех доступных событий.
• Указание флага WaitForMoreEvents не имеет смысла и будет проигнорировано.

void QEventLoop::wakeUp()

Разбуждает цикл обработки событий.

См. также QAbstractEventDispatcher::wakeUp().