Класс QEventLoop

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

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

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

Функции публичного доступа

Переопределённые функции публичного доступа

• 32 функции публичного доступа, унаследованные от QObject

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

• 1 слот публичного доступа, унаследованный от QObject

Дополнительные унаследованные члены

• 1 свойство, унаследованное от QObject
• 2 сигнала, унаследованные от QObject
• 11 статических членов публичного доступа, унаследованные от QObject
• 9 защищённых функций, унаследованные от QObject

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

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

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

См. также QAbstractEventDispatcher.

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

перечисление QEventLoop::ProcessEventsFlagфлаги QEventLoop::ProcessEventsFlags

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

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

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

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

QEventLoop::QEventLoop(QObject *parent = nullptr)

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

[virtual] QEventLoop::~QEventLoop()

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

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

Переопределено из QObject::event().

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

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

Если заданы 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 не имеет смысла и будет проигнорировано.

[slot] void QEventLoop::quit()

Заставляет цикл событий выйти нормально.

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

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

void QEventLoop::wakeUp()

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

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