QEventLoop Class

멤버 함수 문서

[explicit] QEventLoop::QEventLoop(QObject *parent = nullptr)

주어진 parent 으로 이벤트 루프 객체를 생성합니다.

[virtual noexcept] QEventLoop::~QEventLoop()

이벤트 루프 객체를 삭제합니다.

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

다시 구현합니다: QObject::event(QEvent *e).

int QEventLoop::exec(QEventLoop::ProcessEventsFlags flags = AllEvents)

메인 이벤트 루프로 들어가 exit()가 호출될 때까지 기다립니다. exit ()에 전달된 값을 반환합니다.

flags 을 지정하면 flags 에서 허용하는 유형의 이벤트만 처리됩니다.

이벤트 처리를 시작하려면 이 함수를 호출해야 합니다. 메인 이벤트 루프는 창 시스템에서 이벤트를 수신하여 애플리케이션 위젯으로 전송합니다.

일반적으로 실행()을 호출하기 전에는 사용자 상호작용이 이루어질 수 없습니다. 특별한 경우로, 모달 위젯은 자체 로컬 이벤트 루프를 사용하기 때문에 QMessageBox 같은 모달 위젯은 exec()를 호출하기 전에 사용할 수 있습니다.

애플리케이션에서 유휴 처리를 수행하려면(즉, 보류 중인 이벤트가 없을 때마다 특수 함수를 실행하는 경우) 0ns 타임아웃이 있는 QChronoTimer 을 사용하세요. processEvents ()를 사용하면 보다 정교한 유휴 처리 체계를 구현할 수 있습니다.

QCoreApplication::quit(), exit() 및 processEvents()도 참조하세요 .

[slot] void QEventLoop::exit(int returnCode = 0)

반환 코드와 함께 이벤트 루프를 종료하도록 지시합니다.

이 함수가 호출된 후 이벤트 루프는 호출에서 exec()로 반환됩니다. exec () 함수는 returnCode 을 반환합니다.

규칙에 따라 returnCode 0은 성공을 의미하며 0이 아닌 값은 오류를 나타냅니다.

같은 이름의 C 라이브러리 함수와 달리 이 함수는 호출자에게 반환되며 이벤트 처리가 중지된다는 점에 유의하세요.

QCoreApplication::quit(), quit() 및 exec()도 참조하세요 .

bool QEventLoop::isRunning() const

이벤트 루프가 실행 중이면 true 을 반환하고, 그렇지 않으면 false를 반환합니다. 이벤트 루프는 exec()가 호출된 시점부터 exit()가 호출될 때까지 실행 중인 것으로 간주됩니다.

exec() 및 exit()도 참조하세요 .

bool QEventLoop::processEvents(QEventLoop::ProcessEventsFlags flags = AllEvents)

flags 와 일치하는 일부 보류 중인 이벤트를 처리합니다. 보류 중인 이벤트가 처리되면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

이 함수는 오래 실행되는 작업이 있고 사용자 입력을 허용하지 않고 진행 상황을 표시하려는 경우(예: ExcludeUserInputEvents 플래그 사용)에 특히 유용합니다.

이 함수는 QAbstractEventDispatcher::processEvents()의 래퍼일 뿐입니다. 자세한 내용은 해당 함수에 대한 문서를 참조하세요.

[since 6.7] void QEventLoop::processEvents(QEventLoop::ProcessEventsFlags flags, QDeadlineTimer deadline)

deadline 이 만료되거나 처리할 이벤트가 더 이상 없을 때까지 또는 둘 중 먼저 발생하는 시점까지 flags 와 일치하는 보류 중인 이벤트를 처리합니다. 이 기능은 오래 실행되는 작업이 있고 사용자 입력을 허용하지 않고 진행 상황을 표시하려는 경우, 즉 ExcludeUserInputEvents 플래그를 사용하는 경우에 특히 유용합니다.

참고:

• 이 함수는 이벤트를 연속적으로 처리하지 않으며 사용 가능한 모든 이벤트가 처리된 후에 반환됩니다.
• WaitForMoreEvents 플래그를 지정하는 것은 의미가 없으며 무시됩니다.

이 함수는 Qt 6.7에 도입되었습니다.

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

이 함수는 과부하된 함수입니다.

flags 와 일치하는 보류 중인 이벤트를 최대 maxTime 밀리초 동안 또는 처리할 이벤트가 더 이상 없을 때까지 둘 중 더 짧은 시간 동안 처리합니다.

호출과 동일합니다:

processEvents(flags, QDeadlineTimer(maxTime));

[slot] void QEventLoop::quit()

이벤트 루프가 정상적으로 종료되도록 합니다.

exit(0)과 동일합니다.

QCoreApplication::quit() 및 exit()도 참조하세요 .

void QEventLoop::wakeUp()

이벤트 루프를 깨웁니다.

QAbstractEventDispatcher::wakeUp()도 참조하세요 .