QBasicTimer Class
La clase QBasicTimer proporciona eventos de temporizador para objetos. Más...
| Cabecera: | #include <QBasicTimer> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core)target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluidos los heredados
- Miembros obsoletos
- QBasicTimer es parte de Clases de Eventos.
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) |
No Miembros Relacionados
| void | swap(QBasicTimer &lhs, QBasicTimer &rhs) |
Descripción Detallada
Esta es una clase rápida, ligera y de bajo nivel utilizada internamente por Qt. Recomendamos usar la clase de alto nivel QTimer en lugar de esta clase si quieres usar temporizadores en tus aplicaciones. Ten en cuenta que este temporizador es un temporizador repetitivo que enviará eventos de temporizador posteriores 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 con un puntero a una subclase QObject. Cuando el temporizador se agote, enviará un evento de temporizador a la subclase QObject. El temporizador puede detenerse en cualquier momento utilizando stop(). isActive() devuelve true para un temporizador que se está ejecutando; es decir, se ha iniciado, no ha alcanzado el tiempo de espera y no se ha detenido. El ID del temporizador se puede recuperar utilizando timerId().
Los objetos de esta clase no se pueden copiar, pero se pueden mover, por lo que se puede mantener una lista de temporizadores básicos guardándolos en un contenedor que admita tipos de sólo movimiento, por ejemplo, std::vector.
Ver también QTimer, QChronoTimer, QTimerEvent, QObject::timerEvent(), Temporizadores, y Transformaciones Afines.
Documentación de tipos de miembros
[alias] QBasicTimer::Duration
Un tipo std::chrono::duration que se utiliza en varias API de esta clase. Este tipo existe para facilitar una posible transición a una granularidad superior o inferior.
En todas las plataformas actuales, es nanoseconds.
Documentación de funciones miembro
[constexpr noexcept] QBasicTimer::QBasicTimer()
Construye un temporizador básico.
Véase también start().
[noexcept] QBasicTimer::QBasicTimer(QBasicTimer &&other)
Mover-construye un temporizador básico a partir de other, que se deja inactive.
Véase también isActive() y swap().
[noexcept] QBasicTimer::~QBasicTimer()
Destruye 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á un Qt::CoarseTimer. Ver Qt::TimerType para información sobre los diferentes tipos de temporizadores.
El object dado recibirá eventos de temporizador.
A partir de Qt 6.10, establecer un intervalo negativo resultará en una advertencia en tiempo de ejecución y el valor se restablecerá a 1ms. Antes de Qt 6.10, un temporizador Qt permitía establecer un intervalo negativo pero se comportaba de forma sorprendente (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 toma std::chrono::nanosegundos, antes tomaba std::chrono::milisegundos. Este cambio es compatible con versiones anteriores.
Esta función se introdujo en Qt 6.5.
Ver 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 dado timerType. Ver Qt::TimerType para información sobre los diferentes tipos de temporizadores.
A partir de Qt 6.10, establecer un intervalo negativo resultará en una advertencia en tiempo de ejecución y el valor se restablecerá a 1ms. Antes de Qt 6.10 un temporizador Qt te permitía establecer un intervalo negativo pero se comportaba de formas sorprendentes (por ejemplo parar el temporizador si estaba en marcha o no iniciarlo en absoluto).
obj recibirá eventos del temporizador.
Nota: A partir de Qt 6.9 este método toma std::chrono::nanosegundos, antes tomaba std::chrono::milisegundos. Este cambio es compatible con versiones anteriores.
Se trata de una función sobrecargada.
Esta función se introdujo en Qt 6.5.
Ver 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)
Cambia este temporizador por other. Esta operación es muy rápida y nunca falla.
[noexcept] QBasicTimer &QBasicTimer::operator=(QBasicTimer &&other)
Mover-asigna other a este temporizador básico. El temporizador previamente representado por este temporizador básico se detiene. other se deja como inactive.
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.
