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 |
- Lista de todos los miembros, incluidos los miembros heredados
- Miembros obsoletos
- QBasicTimer forma parte de las 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) |
Elementos no miembros relacionados
| 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.
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.