QAbstractEventDispatcher Class

メンバ関数 ドキュメント

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

与えられたparent で新しいイベントディスパッチャを構築する。

[virtual noexcept] QAbstractEventDispatcher::~QAbstractEventDispatcher()

イベントディスパッチャを破棄します。

[signal] void QAbstractEventDispatcher::aboutToBlock()

このシグナルは、イベントループがブロックする可能性のある関数を呼び出す前に発せられます。

awake()も参照 。

[signal] void QAbstractEventDispatcher::awake()

このシグナルは、イベントループがブロックされる可能性のある関数から戻った後に発せられます。

wakeUp() およびaboutToBlock() も参照 。

bool QAbstractEventDispatcher::filterNativeEvent(const QByteArray &eventType, void *message, qintptr *result)

installNativeEventFilter() で設定されたイベント・フィルターを通してmessage を送出する。この関数は、イベント・フィルタがtrue を返すとすぐにtrue を返し、そうでない場合はイベントの処理を続行することを示す false を返します。

QAbstractEventDispatcher のサブクラスは、アプリケーションで使用される可能性のある拡張との互換性 を確保するために、システムから受信したすべてのメッセージに対してこの関数を呼 び出さなければならない。イベント・タイプeventType は、実行時に選択されるプラットフォーム・プラ グインに固有であり、メッセージを適切なタイプにキャストするために使用できま す。result ポインタは Windows でのみ使用され、LRESULT ポインタに対応する。

message の型はプラットフォーム依存であることに注意。詳細はQAbstractNativeEventFilter を参照。

installNativeEventFilter() およびQAbstractNativeEventFilter::nativeEventFilter()も参照のこと 。

void QAbstractEventDispatcher::installNativeEventFilter(QAbstractNativeEventFilter *filterObj)

アプリケーションによって受信されるすべてのネイティブ・イベントに対するイベント・フィルタfilterObj をインストールする。

イベント・フィルタfilterObj は、nativeEventFilter() 関数を介してイベントを受信します。 () 関数は、すべてのスレッドが受信するすべてのイベントに対して呼び出されます。

nativeEventFilter() 関数は、イベントをフィルタリングする必要がある場合、true を返す必要があります（この場合は停止）。ネイティブイベントは、QEvent に変換され、標準の Qtevent フィルタリング、例えばQObject::installEventFilter() によって処理されます。

複数のイベントフィルターがインストールされている場合、最後にインストールされたフィルターが最初に有効になります。

移植性を最大にするために、可能な限り常にQEvent オブジェクトとQObject::installEventFilter() を使用するようにしてください。

QObject::installEventFilter()も参照してください 。

[static] QAbstractEventDispatcher *QAbstractEventDispatcher::instance(QThread *thread = nullptr)

指定されたthread のイベントディスパッチャオブジェクトへのポインタを返す。thread がnullptr の場合、現在のスレッドが使用される。指定されたスレッドのイベント・ディスパッチャが存在しない場合、この関数はnullptr を返します。

注意:Qt がスレッドサポートなしでビルドされている場合、thread 引数は無視されます。

[pure virtual] void QAbstractEventDispatcher::interrupt()

イベントディスパッチに割り込みます。イベントディスパッチャは、できるだけ早くprocessEvents() から戻ります。

[pure virtual] bool QAbstractEventDispatcher::processEvents(QEventLoop::ProcessEventsFlags flags)

処理するイベントがなくなるまで、flags にマッチする保留中のイベントを処理します。イベントが処理された場合はtrue を返し、そうでない場合はfalse を返す。

この関数は、長時間の処理があり、QEventLoop::ExcludeUserInputEvents フラグを使用してユーザー入力を許可せずに処理の進捗を表示したい場合に特に有用である。

flags でQEventLoop::WaitForMoreEvents フラグが設定されている場合、この関数の動作は以下のようになる：

• イベントが利用可能な場合、この関数はそれらを処理した後に戻る。
• 利用可能なイベントがない場合、この関数は利用可能なイベントが増えるまで待機し、新たに利用可能になったイベントを処理した後に戻ります。

flags でQEventLoop::WaitForMoreEvents フラグが設定されておらず、利用可能なイベントがない場合、この関数は即座に戻ります。

注意：この関数は連続的にイベントを処理するのではなく、利用可能なイベントがすべて処理された後に戻る。

[pure virtual] void QAbstractEventDispatcher::registerSocketNotifier(QSocketNotifier *notifier)

notifier をイベント・ループに登録します。サブクラスは、ソケット通知器を別のイベントループに結びつけるために、このメソッドを実装する必要がある。

[since 6.8] void QAbstractEventDispatcher::registerTimer(Qt::TimerId timerId, QAbstractEventDispatcher::Duration interval, Qt::TimerType timerType, QObject *object)

指定されたtimerId 、interval 、timerType のタイマーを、指定されたobject に登録する。

この関数はQt 6.8で導入された。

unregisterTimer() とtimersForObject()も参照 。

[pure virtual] void QAbstractEventDispatcher::registerTimer(int timerId, qint64 interval, Qt::TimerType timerType, QObject *object)

与えられたobject に対して、指定されたtimerId 、interval 、timerType でタイマーを登録します。

[since 6.8] Qt::TimerId QAbstractEventDispatcher::registerTimer(QAbstractEventDispatcher::Duration interval, Qt::TimerType timerType, QObject *object)

これはオーバーロードされた関数です。

与えられたobject に対して、指定されたinterval とtimerType でタイマーを登録し、タイマー ID を返します。

この関数はQt 6.8で導入されました。

[pure virtual] QList<QAbstractEventDispatcher::TimerInfo> QAbstractEventDispatcher::registeredTimers(QObject *object) const

object に対して登録されたタイマーのリストを返します。TimerInfo struct にはtimerId 、interval 、timerType のメンバがあります。

Qt::TimerTypeも参照してください 。

[pure virtual] int QAbstractEventDispatcher::remainingTime(int timerId)

与えられたtimerId の残り時間をミリ秒単位で返します。タイマーが非アクティブの場合、返される値は-1であり、タイマーが時間超過の場合、返される値は0である。

Qt::TimerTypeも参照のこと 。

QAbstractEventDispatcher::Duration QAbstractEventDispatcher::remainingTime(Qt::TimerId timerId) const

タイマーの残り時間を、与えられたtimerId で返します。タイマーが非アクティブの場合、返される値は負になる。タイマーの残り時間が超過している場合、返される値は 0 になります。

Qt::TimerType 、registerTimer()、およびunregisterTimer()も参照して ください。

void QAbstractEventDispatcher::removeNativeEventFilter(QAbstractNativeEventFilter *filter)

このオブジェクトからイベント・フィルタfilter を削除します。そのようなイベント・フィルタがインストールされていない場合、要求は無視されます。

このオブジェクトのすべてのイベント・フィルターは、このオブジェクトが破棄されるときに自動的に削除されます。

イベント・フィルタの起動中であっても（つまり、nativeEventFilter （）関数の中であっても）、イベント・フィルタを削除することは常に安全です。

installNativeEventFilter() およびQAbstractNativeEventFilterも参照のこと 。

[since 6.8] QList<QAbstractEventDispatcher::TimerInfoV2> QAbstractEventDispatcher::timersForObject(QObject *object) const

object の登録済みタイマーのリストを返す。TimerInfoV2 構造体は、timerId 、interval 、timerType メンバを持ちます。

この関数は Qt 6.8 で導入されました。

Qt::TimerType,registerTimer(),unregisterTimer()も参照してください 。

[pure virtual] void QAbstractEventDispatcher::unregisterSocketNotifier(QSocketNotifier *notifier)

イベント・ディスパッチャからnotifier の登録を解除します。サブクラスは、ソケット通知器を別のイベントループに結びつけるために、このメソッドを再実装する必要がある。再実装は基本実装を呼び出さなければならない。

[since 6.8] bool QAbstractEventDispatcher::unregisterTimer(Qt::TimerId timerId)

与えられたtimerId のタイマーの登録を解除する。成功すればtrue を返し、そうでなければfalse を返す。

この関数は Qt 6.8 で導入されました。

registerTimer() およびunregisterTimers()も参照してください 。

[pure virtual] bool QAbstractEventDispatcher::unregisterTimer(int timerId)

与えられたtimerId のタイマーの登録を解除する。成功すればtrue を返し、そうでなければfalse を返す。

registerTimer() およびunregisterTimers()も参照のこと 。

[pure virtual] bool QAbstractEventDispatcher::unregisterTimers(QObject *object)

与えられたobject に関連付けられたすべてのタイマーの登録を解除する。すべてのタイマーの削除に成功した場合はtrue を返し、失敗した場合はfalse を返します。

unregisterTimer() およびregisteredTimers()も参照 。

[pure virtual] void QAbstractEventDispatcher::wakeUp()

イベント・ループをウェイクアップします。

注意：この関数はスレッドセーフです。

awake()も参照して ください。