qiurui
/
qtbase
mirror of https://github.com/qt/qtbase.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

QTimer: Doc: Distribute existing note to useful places 

Amends 146749f9b7

Pick-to: 6.8 6.10
Change-Id: Id4e861faaf1d268692ec496fdcb2e69c8acd694f
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
This commit is contained in:
Andre Hartmann 2025-07-15 14:46:29 +02:00 committed by André Hartmann
parent 959866f198
commit c887a780fd
1 changed files with 10 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
src/corelib/kernel/qtimer.cpp
View File

@ -205,6 +205,11 @@ Qt::TimerId QTimer::id() const
//! [singleshot-activation] //! [singleshot-activation]
If \l singleShot is true, the timer will be activated only once. If \l singleShot is true, the timer will be activated only once.
//! [singleshot-activation] //! [singleshot-activation]
//! [eventloop-busy]
\note Keeping the event loop busy with a zero-timer is bound to
cause trouble and highly erratic behavior of the UI.
//! [eventloop-busy]
*/ */
void QTimer::start() void QTimer::start()
{ {
@ -236,8 +241,7 @@ void QTimer::start()
\include timers-common.qdocinc negative-intervals-not-allowed \include timers-common.qdocinc negative-intervals-not-allowed
\note Keeping the event loop busy with a zero-timer is bound to \include qtimer.cpp eventloop-busy
cause trouble and highly erratic behavior of the UI.
*/ */
void QTimer::start(int msec) void QTimer::start(int msec)
{ {
@ -277,6 +281,8 @@ checkInterval(const char *caller, std::chrono::milliseconds interval)
\include qtimer.cpp singleshot-activation \include qtimer.cpp singleshot-activation
\include timers-common.qdocinc negative-intervals-not-allowed \include timers-common.qdocinc negative-intervals-not-allowed
\include qtimer.cpp eventloop-busy
*/ */
void QTimer::start(std::chrono::milliseconds interval) void QTimer::start(std::chrono::milliseconds interval)
{ {
@ -631,6 +637,8 @@ QBindable<bool> QTimer::bindableSingleShot()
interval of 0 will time out as soon as all the events in the window interval of 0 will time out as soon as all the events in the window
system's event queue have been processed. system's event queue have been processed.
\include qtimer.cpp eventloop-busy
Setting the interval of a running timer will change the interval, Setting the interval of a running timer will change the interval,
stop() and then start() the timer, and acquire a new id(). stop() and then start() the timer, and acquire a new id().
If the timer is not running, only the interval is changed. If the timer is not running, only the interval is changed.