Класс 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 миллисекунд или до тех пор, пока больше нет событий для обработки, что произойдёт раньше. Эта функция особенно полезна, если у вас есть длительная операция, и вы хотите отобразить её прогресс, не разрешая ввод пользователя, т. е. используя флаг ExcludeUserInputEvents.

Примечания:

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

void QEventLoop::wakeUp()

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

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