From 25b8af074763c0f9a8fa8fba6ff6ac7235afad87 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tor=20Arne=20Vestb=C3=B8?= Date: Fri, 7 Sep 2018 10:50:07 +0200 Subject: Clarify behavior of QAbstractEventDispatcher::processEvents MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The function, although implemented differently in each event dispatcher, is not supposed to process newly posted events, only the events that were queued at the time of the call. This is tested by tst_QEventDispatcher::processEventsOnlySendsQueuedEvents, which is not blacklisted on any platforms, so we know it's the behavior in practice. Change-Id: If9a874eeeb8ebcebe88ed119b065ae12fc545129 Reviewed-by: Paul Wicking Reviewed-by: Edward Welbourne Reviewed-by: Tor Arne Vestbø --- src/corelib/kernel/qabstracteventdispatcher.cpp | 9 +++++++++ 1 file changed, 9 insertions(+) (limited to 'src/corelib/kernel/qabstracteventdispatcher.cpp') diff --git a/src/corelib/kernel/qabstracteventdispatcher.cpp b/src/corelib/kernel/qabstracteventdispatcher.cpp index 655fe58f98..8e1b560874 100644 --- a/src/corelib/kernel/qabstracteventdispatcher.cpp +++ b/src/corelib/kernel/qabstracteventdispatcher.cpp @@ -207,6 +207,15 @@ QAbstractEventDispatcher *QAbstractEventDispatcher::instance(QThread *thread) \sa hasPendingEvents() */ +/*! + \internal + + \note processEvents() only processes events queued before the function + is called. Events that are posted while the function runs will be queued + until a later round of event processing. This only applies to posted Qt + events. For timers and system level events, the situation is unknown. +*/ + /*! \fn bool QAbstractEventDispatcher::hasPendingEvents() \deprecated -- cgit v1.2.3