\inmodule QtCore More...

#include <qbasictimer.h>

Collaboration diagram for QBasicTimer:

Public Member Functions
constexpr	QBasicTimer () noexcept
	Constructs a basic timer.

	~QBasicTimer ()
	Destroys the basic timer.

	QBasicTimer (QBasicTimer &&other) noexcept

void	swap (QBasicTimer &other) noexcept

bool	isActive () const noexcept
	Returns `true` if the timer is running and has not been stopped; otherwise returns `false`.

int	timerId () const noexcept
	Returns the timer's ID.

void	start (int msec, QObject *obj)
	\obsolete Use chrono overload instead.

void	start (int msec, Qt::TimerType timerType, QObject *obj)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. \obsolete.

void	start (std::chrono::milliseconds duration, QObject *obj)

void	start (std::chrono::milliseconds duration, Qt::TimerType timerType, QObject *obj)

void	stop ()
	Stops the timer.

Related Symbols
(Note that these are not member symbols.)
	swap (QBasicTimer &lhs, QBasicTimer &rhs)

Detailed Description

\inmodule QtCore

The QBasicTimer class provides timer events for objects.

This is a fast, lightweight, and low-level class used by Qt internally. We recommend using the higher-level QTimer class rather than this class if you want to use timers in your applications. Note that this timer is a repeating timer that will send subsequent timer events unless the stop() function is called.

To use this class, create a QBasicTimer, and call its start() function with a timeout interval and with a pointer to a QObject subclass. When the timer times out it will send a timer event to the QObject subclass. The timer can be stopped at any time using stop(). isActive() returns true for a timer that is running; i.e. it has been started, has not reached the timeout time, and has not been stopped. The timer's ID can be retrieved using timerId().

Objects of this class cannot be copied, but can be moved, so you can maintain a list of basic timers by holding them in container that supports move-only types, e.g. std::vector.

See also: QTimer, QChronoTimer, QTimerEvent, QObject::timerEvent(), Timers, {Affine Transformations}

Definition at line 17 of file qbasictimer.h.

Constructor & Destructor Documentation

◆ QBasicTimer() [1/2]

QBasicTimer::QBasicTimer ( )

inlineconstexprnoexcept

Constructs a basic timer.

See also: start()

Definition at line 23 of file qbasictimer.h.

◆ ~QBasicTimer()

QBasicTimer::~QBasicTimer ( )

inline

Destroys the basic timer.

Definition at line 24 of file qbasictimer.h.

◆ QBasicTimer() [2/2]

QBasicTimer::QBasicTimer ( QBasicTimer && other )

inlinenoexcept

Since: 5.14

Move-constructs a basic timer from other, which is left \l{isActive()}{inactive}.

See also: isActive(), swap()

Definition at line 26 of file qbasictimer.h.

References other().

Here is the call graph for this function:

Member Function Documentation

◆ isActive()

bool QBasicTimer::isActive ( ) const

inlinenoexcept

Returns true if the timer is running and has not been stopped; otherwise returns false.

See also: start(), stop()

Definition at line 34 of file qbasictimer.h.

Referenced by QPollingFileSystemWatcherEngine::addPaths(), QHeaderViewPrivate::doDelayedResizeSections(), QWaylandQuickShellEventFilter::eventFilter(), QHeaderViewPrivate::executePostedResize(), QQuickTextInputPrivate::handleFocusEvent(), QTipLabel::hideTip(), QQuickPressHandler::isActive(), QWidgetTextControlPrivate::mousePressEvent(), QNmeaSatelliteInfoSourcePrivate::notifyNewUpdate(), QNmeaPositionInfoSourcePrivate::notifyNewUpdate(), QQC2::QWindowsStyle::polish(), QMacPanGestureRecognizer::recognize(), QUnifiedTimer::setTimingInterval(), QMenuPrivate::DelayState::start(), QMenuSloppyState::startTimerIfNotRunning(), QMacPanGestureRecognizer::timerEvent(), QUnifiedTimer::updateAnimationTimers(), and QQuickTapHandler::wantsEventPoint().

Here is the caller graph for this function:

◆ start() [1/4]

void QBasicTimer::start	(	int	msec,
		QObject *	obj )

\obsolete Use chrono overload instead.

Referenced by QMenuBarPrivate::_q_internalShortcutActivated(), QPollingFileSystemWatcherEngine::addPaths(), QComboBoxPrivate::adjustComboBoxSize(), QQuickFlickablePrivate::captureDelayedPress(), QAbstractItemViewPrivate::doDelayedItemsLayout(), QHeaderViewPrivate::doDelayedResizeSections(), QWaylandQuickShellEventFilter::eventFilter(), QTipLabel::hideTip(), QQuickViewPrivate::itemGeometryChanged(), QQuickWidgetPrivate::itemGeometryChanged(), QWidgetTextControlPrivate::mouseDoubleClickEvent(), QQuickPressHandler::mousePressEvent(), QQC2::QWindowsStyle::polish(), QMacPanGestureRecognizer::recognize(), QTipLabel::restartExpireTimer(), QPulseAudioSource::resume(), QMenuPrivate::DelayState::start(), QQuickToolTipPrivate::startDelay(), QQuickToolTipPrivate::startTimeout(), QMenuSloppyState::startTimer(), QNmeaPositionInfoSourcePrivate::startUpdates(), QNmeaSatelliteInfoSourcePrivate::startUpdates(), QWidgetTextControlPrivate::updateCursorBlinking(), and QQuickTextControlPrivate::updateCursorFlashTime().

Here is the caller graph for this function:

◆ start() [2/4]

QBasicTimer::start	(	int	msec,
		Qt::TimerType	timerType,
		QObject *	obj )

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. \obsolete.

Use chrono overload instead.

◆ start() [3/4]

void QBasicTimer::start	(	std::chrono::milliseconds	duration,
		QObject *	object )

Since: 6.5

Starts (or restarts) the timer with a duration timeout. The timer will be a Qt::CoarseTimer. See Qt::TimerType for information on the different timer types.

The given object will receive timer events.