Temporizadores

QObject, la clase base de todos los objetos Qt, proporciona el soporte básico para temporizadores en Qt. Con ` QObject::startTimer()` se inicia un temporizador con un intervalo en milisegundos como argumento. La función devuelve un identificador de temporizador único de tipo entero. A continuación, el temporizador se activará a intervalos regulares hasta que se llame explícitamente a ` QObject::killTimer()` con ese identificador de temporizador.

En lugar de gestionar directamente los identificadores de temporizador, puedes utilizar ` QBasicTimer`. ` QBasicTimer ` es una clase de valor, un envoltorio RAII que envuelve un identificador de temporizador. El temporizador se inicia con ` QBasicTimer::start()` y se detiene con ` QBasicTimer::stop()` (esta última también se invoca al destruirse). Para utilizar ` QBasicTimer`, debes reimplementar ` timerEvent()` en tu clase (que debe ser una subclase de ` QObject`) y gestionar allí el evento del temporizador.

Para que este mecanismo funcione, la aplicación debe ejecutarse en un bucle de eventos. Puedes iniciar un bucle de eventos con QCoreApplication::exec(). Para Qt Widgets las aplicaciones, véase QApplication::exec(). Cuando se activa un temporizador, la aplicación envía un QTimerEvent, y el flujo de control abandona el bucle de eventos hasta que se procesa el evento del temporizador. Esto implica que un temporizador no puede activarse mientras la aplicación está ocupada realizando otra tarea. En otras palabras: la precisión de los temporizadores depende de la granularidad de la aplicación. La precisión de los temporizadores también depende del sistema operativo y del hardware subyacentes. Los intervalos cortos pueden ser redondeados o retrasados por el programador del sistema, y todos los tipos de temporizadores pueden agotarse más tarde de lo solicitado si el sistema está ocupado. Para obtener más información sobre la resolución de los temporizadores y Qt::TimerType, consulta la documentación de QTimer.

En aplicaciones multihilo, puede utilizar el mecanismo de temporizador en cualquier hilo que tenga un bucle de eventos. Para iniciar un bucle de eventos desde un hilo que no sea de la interfaz gráfica de usuario, utilice ` QThread::exec()`. Qt utiliza el ` thread affinity ` del objeto para determinar qué hilo entregará el ` QTimerEvent`. Por este motivo, debe iniciar y detener todos los temporizadores en el hilo del objeto; no es posible iniciar temporizadores para objetos en otro hilo.

La API principal para la funcionalidad de temporizadores es ` QTimer`. ` QTimer ` almacena el intervalo en un entero con signo, lo que limita el intervalo máximo que admite al número de milisegundos que caben en un entero con signo (en la práctica, esto supone un periodo de unos 24 días).

Qt 6.8 introdujo la clase ` QChronoTimer `. La principal diferencia entre ambas clases es que ` QChronoTimer ` admite un rango de intervalos mayor y una mayor precisión (std::chrono::nanoseconds). Para ` QTimer `, el intervalo máximo admitido es de ±24 días, mientras que para ` QChronoTimer ` es de ±292 años. Si solo necesitas una resolución de milisegundos y un rango de ±24 días, puedes seguir utilizando QTimer. Ten en cuenta que QChronoTimer existe principalmente porque la precisión de QTimer no se podía cambiar a std::chrono::nanoseconds sin romper la compatibilidad binaria.

QTimer Proporciona temporizadores regulares que emiten una señal cuando se activan, y hereda de QObject para que encaje bien en la estructura de propiedad de la mayoría de los programas Qt. La forma habitual de utilizarlo es la siguiente:

        QTimer *timer = new QTimer(1s, this);
        connect(timer, &QTimer::timeout, this, &MyWidget::processOneThing);
        timer->start();
        auto *timer = new QTimer(this);
        connect(timer, &QTimer::timeout, this, &MyWidget::processOneThing);
        timer->setInterval(1s);
        timer->start();

El objeto ` QTimer ` se convierte en un hijo del objeto ` this `, de modo que, cuando se destruye ` this `, el temporizador también se destruye. A continuación, la señal ` timeout()` se conecta a la ranura que realizará la tarea; el intervalo del temporizador puede pasarse al constructor o establecerse más adelante con `setInterval()`.

QTimer También proporciona funciones estáticas para temporizadores de un solo disparo. Por ejemplo:

        MyWidget widget;
        QTimer::singleShot(200ms, &widget, &MyWidget::updateCaption);

200 ms después de que se ejecute esta línea de código, se llamará a la ranura « updateCaption() ».

Para que « QTimer » funcione, debes tener un bucle de eventos en tu aplicación; es decir, debes llamar a « QCoreApplication::exec()» en algún lugar. Los eventos del temporizador solo se entregarán mientras el bucle de eventos esté en ejecución.

En aplicaciones multihilo, puedes utilizar ` QTimer ` en cualquier hilo que tenga un bucle de eventos. Para iniciar un bucle de eventos desde un hilo que no sea de la interfaz gráfica de usuario, utiliza ` QThread::exec()`. Qt utiliza el parámetro « thread affinity » del temporizador para determinar qué hilo emitirá la señal « timeout()». Por este motivo, debe iniciar y detener el temporizador en su propio hilo; no es posible iniciar un temporizador desde otro hilo.

El ejemplo «Analog Clock » muestra cómo utilizar « QTimer » para redibujar un widget a intervalos regulares. De la implementación de « AnalogClock »:

AnalogClock::AnalogClock(QWidget *parent)
    : QWidget(parent)
{
    QTimer *timer = new QTimer(this);
    connect(timer, &QTimer::timeout, this, QOverload<>::of(&AnalogClock::update));
    timer->start(1000);

    setWindowTitle(tr("Analog Clock"));
    resize(200, 200);
}

Cada segundo, ` QTimer ` llamará a la ranura ` QWidget::update()` para actualizar la visualización del reloj.

© 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.