En esta página

QBasicTimer Class

La clase QBasicTimer proporciona eventos de temporizador para los objetos. Más información...

Encabezado: #include <QBasicTimer>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Tipos públicos

Funciones públicas

QBasicTimer()
QBasicTimer(QBasicTimer &&other)
~QBasicTimer()
(since 6.8) Qt::TimerId id() const
bool isActive() const
(since 6.5) void start(QBasicTimer::Duration duration, QObject *object)
(since 6.5) void start(QBasicTimer::Duration duration, Qt::TimerType timerType, QObject *obj)
void stop()
void swap(QBasicTimer &other)
QBasicTimer &operator=(QBasicTimer &&other)
void swap(QBasicTimer &lhs, QBasicTimer &rhs)

Descripción detallada

Se trata de una clase rápida, ligera y de bajo nivel que utiliza Qt internamente. Recomendamos utilizar la clase de nivel superior QTimer en lugar de esta clase si deseas utilizar temporizadores en tus aplicaciones. Ten en cuenta que este temporizador es un temporizador repetitivo que enviará eventos de temporizador sucesivos a menos que se llame a la función stop().

Para utilizar esta clase, crea un `QBasicTimer` y llama a su función ` start()` con un intervalo de tiempo de espera y un puntero a una subclase de ` QObject `. Cuando el temporizador alcance el tiempo de espera, enviará un evento de temporizador a la subclase ` QObject `. El temporizador se puede detener en cualquier momento mediante ` stop()`. ` isActive()` devuelve ` true ` para un temporizador que está en ejecución; es decir, que se ha iniciado, no ha alcanzado el tiempo de espera y no se ha detenido. El ID del temporizador se puede obtener mediante `timerId()`.

Los objetos de esta clase no se pueden copiar, pero sí se pueden mover, por lo que puedes mantener una lista de temporizadores básicos almacenándolos en un contenedor que admita tipos de solo movimiento, por ejemplo, std::vector.

Véase también QTimer, QChronoTimer, QTimerEvent, QObject::timerEvent(), Temporizadores y Transformaciones afines.

Documentación sobre tipos de miembros

[alias] QBasicTimer::Duration

Un tipo de « std::chrono::duration » que se utiliza en varias API de esta clase. Este tipo existe para facilitar una posible transición a una granularidad mayor o menor.

En todas las plataformas actuales, es de tipo nanoseconds.

Documentación de las funciones miembro

[constexpr noexcept] QBasicTimer::QBasicTimer()

Crea un temporizador básico.

Véase también start().

[noexcept] QBasicTimer::QBasicTimer(QBasicTimer &&other)

Move crea un temporizador básico a partir de other, que queda en inactive.

Véase también isActive() y swap().

[noexcept] QBasicTimer::~QBasicTimer()

Elimina el temporizador básico.

[noexcept, since 6.8] Qt::TimerId QBasicTimer::id() const

Devuelve el ID del temporizador.

Esta función se introdujo en Qt 6.8.

Véase también QTimerEvent::id().

[noexcept] bool QBasicTimer::isActive() const

Devuelve true si el temporizador está en marcha y no se ha detenido; en caso contrario, devuelve false.

Véase también start() y stop().

[since 6.5] void QBasicTimer::start(QBasicTimer::Duration duration, QObject *object)

Inicia (o reinicia) el temporizador con un tiempo de espera de duration. El temporizador será de tipo Qt::CoarseTimer. Consulta Qt::TimerType para obtener información sobre los diferentes tipos de temporizadores.

El object especificado recibirá los eventos del temporizador.

A partir de Qt 6.10, establecer un intervalo negativo provocará una advertencia en tiempo de ejecución y el valor se restablecerá a 1 ms. Antes de Qt 6.10, un temporizador de Qt permitía establecer un intervalo negativo, pero se comportaba de forma impredecible (por ejemplo, detenía el temporizador si estaba en marcha o no lo iniciaba en absoluto).

Nota: A partir de Qt 6.9, este método admite std::chrono::nanoseconds; antes admitía std::chrono::milliseconds. Este cambio es compatible con versiones anteriores.

Esta función se introdujo en Qt 6.5.

Véase también stop(), isActive(), QObject::timerEvent() y Qt::CoarseTimer.

[since 6.5] void QBasicTimer::start(QBasicTimer::Duration duration, Qt::TimerType timerType, QObject *obj)

Inicia (o reinicia) el temporizador con un tiempo de espera de duration y el valor de timerType indicado. Consulta Qt::TimerType para obtener información sobre los diferentes tipos de temporizadores.

A partir de Qt 6.10, establecer un intervalo negativo provocará una advertencia en tiempo de ejecución y el valor se restablecerá a 1 ms. Antes de Qt 6.10, un temporizador de Qt permitía establecer un intervalo negativo, pero se comportaba de formas inesperadas (por ejemplo, detenía el temporizador si estaba en marcha o no lo iniciaba en absoluto).

obj recibirá eventos del temporizador.

Nota: A partir de Qt 6.9, este método admite std::chrono::nanoseconds; anteriormente, admitía std::chrono::milliseconds. Este cambio es compatible con versiones anteriores.

Se trata de una función sobrecargada.

Esta función se introdujo en Qt 6.5.

Véase también stop(), isActive(), QObject::timerEvent() y Qt::TimerType.

void QBasicTimer::stop()

Detiene el temporizador.

Véase también start() y isActive().

[noexcept] void QBasicTimer::swap(QBasicTimer &other)

Sustituye este temporizador por other. Esta operación es muy rápida y nunca falla.

[noexcept] QBasicTimer &QBasicTimer::operator=(QBasicTimer &&other)

La operación «Move» asigna other a este temporizador básico. El temporizador que anteriormente representaba este temporizador básico se detiene. other se mantiene como inactive.

Véase también stop(), isActive() y swap().

Elementos no miembros relacionados

[noexcept] void swap(QBasicTimer &lhs, QBasicTimer &rhs)

Cambia el temporizador lhs por rhs. Esta operación es muy rápida y nunca falla.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.