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 で許可されたタイプのイベントのみが処理されます。

イベント処理を開始するには、この関数を呼び出す必要があります。メインイベントループはウィンドウシステムからイベントを受け取り、それらをアプリケーションウィジェットにディスパッチします。

一般的に、exec() を呼び出すまでは、ユーザーとの対話を行うことはできません。例外として、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)

flags に一致する保留中のイベントを、deadline の有効期限が切れるか、処理すべきイベントがなくなるかのいずれか早い方まで処理します。この関数は、長時間かかる操作があり、ユーザー入力を許可せずに（つまり、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()も参照してください 。