Класс QEventLoop

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

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

Типы public

Функции public

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

Public Slots

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

В любое время вы можете создать объект 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().