QTimer Class

Documentación de las funciones miembro

[explicit] QTimer::QTimer(QObject *parent = nullptr)

Construye un temporizador con la dirección parent.

[virtual noexcept] QTimer::~QTimer()

Destruye el temporizador.

template <typename Functor> QMetaObject::Connection QTimer::callOnTimeout(Functor &&slot)

Crea una conexión desde la señal timeout() del temporizador a slot. Devuelve un "handle" a la conexión.

Este método se proporciona por conveniencia. Es equivalente a llamar:

QObject::connect(timer, &QTimer::timeout, timer, slot, Qt::DirectConnection);

Véase también QObject::connect() y timeout().

template <typename Functor> QMetaObject::Connection QTimer::callOnTimeout(const QObject *context, Functor &&slot, Qt::ConnectionType connectionType = Qt::AutoConnection)

Crea una conexión desde la señal timeout() a slot para ser colocada en un bucle de eventos específico de context, y devuelve un handle a la conexión.

Este método se proporciona por conveniencia. Es equivalente a llamar a

QObject::connect(timer, &QTimer::timeout, context, slot, connectionType);

Véase también QObject::connect() y timeout().

[since 6.8] Qt::TimerId QTimer::id() const

Devuelve un Qt::TimerId que representa el ID del temporizador si el temporizador está en marcha; en caso contrario devuelve Qt::TimerId::Invalid.

Esta función se introdujo en Qt 6.8.

Véase también Qt::TimerId.

std::chrono::milliseconds QTimer::intervalAsDuration() const

Devuelve el intervalo de este temporizador como un objeto std::chrono::milliseconds.

Véase también interval.

bool QTimer::isActive() const

Devuelve true si el temporizador está en marcha; en caso contrario devuelve false.

std::chrono::milliseconds QTimer::remainingTimeAsDuration() const

Devuelve el tiempo restante de este objeto temporizador como un objeto std::chrono::milliseconds. Si este temporizador está vencido o retrasado, el valor devuelto es std::chrono::milliseconds::zero(). Si no se ha podido encontrar el tiempo restante o el temporizador no está en marcha, esta función devuelve una duración negativa.

Véase también remainingTime().

Esta función estática llama a functor después de interval.

Es muy conveniente utilizar esta función porque no es necesario molestarse con un timerEvent o crear un objeto local QTimer.

Si se especifica context, se llamará a functor sólo si el objeto context no ha sido destruido antes de que se produzca el intervalo. El functor se ejecutará entonces el hilo de context. El hilo del contexto debe tener un bucle de eventos Qt en ejecución.

Si functor es una función miembro de context, entonces la función será llamada sobre el objeto.

El parámetro interval puede ser un int (interpretado como una cuenta de milisegundos) o un tipo std::chrono que implícitamente se convierte a nanosegundos.

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

Nota: Esta función es reentrante.

Véase también start().

[static] void QTimer::singleShot(std::chrono::nanoseconds nsec, const QObject *receiver, const char *member)

Esta función estática llama a una ranura después de un intervalo de tiempo dado.

Es muy conveniente utilizar esta función porque no es necesario molestarse con un timerEvent o crear un objeto local QTimer.

receiver es el objeto receptor y member es la ranura. El intervalo de tiempo se indica en el objeto de duración nsec.

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 Timer permitía establecer un intervalo negativo pero se comportaba de formas sorprendentes (por ejemplo detener el temporizador si estaba en ejecución o no iniciarlo en absoluto).

Nota: Esta función es reentrante.

Véase también start().

[static] void QTimer::singleShot(std::chrono::nanoseconds nsec, Qt::TimerType timerType, const QObject *receiver, const char *member)

Esta función estática llama a una ranura después de un intervalo de tiempo dado.

Es muy conveniente utilizar esta función porque no es necesario molestarse con un timerEvent o crear un objeto local QTimer.

receiver es el objeto receptor y member es la ranura. El intervalo de tiempo se indica en el objeto de duración nsec. El timerType afecta a la precisión del 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: Esta función es reentrante.

Véase también start().

[slot] void QTimer::start(int msec)

Inicia o reinicia el temporizador con un intervalo de tiempo de espera de msec milisegundos.

Esto equivale a:

timer.setInterval(msec);
timer.start();

Si el temporizador ya está en marcha, será stopped y reiniciado. Esto también cambiará su id().

Si singleShot es verdadero, el temporizador se activará sólo una vez.

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

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        timer, qOverload(&QTimer::start));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        timer, [receiver = timer](int msec) { receiver->start(msec); });

[slot] void QTimer::start()

Inicia o reinicia el temporizador con el tiempo de espera especificado en interval.

Si el temporizador ya está en marcha, será stopped y reiniciado. Esto también cambiará su id().

Si singleShot es verdadero, el temporizador se activará sólo una vez.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        timer, qOverload<>(&QTimer::start));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        timer, [receiver = timer]() { receiver->start(); });

void QTimer::start(std::chrono::milliseconds interval)

Inicia o reinicia el temporizador con un tiempo de espera de duración interval milisegundos.

Esto equivale a:

timer.setInterval(interval);
timer.start();

Si el temporizador ya está en marcha, se stopped reiniciará. Esto también cambiará su id().

Si singleShot es verdadero, el temporizador se activará sólo una vez.

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

[slot] void QTimer::stop()

Detiene el temporizador.

Véase también start().

[private signal] void QTimer::timeout()

Esta señal se emite cuando el temporizador se agota.

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

[override virtual protected] void QTimer::timerEvent(QTimerEvent *e)

Reimplementa: QObject::timerEvent(QTimerEvent *event).

int QTimer::timerId() const

Devuelve el ID del temporizador si el temporizador está en marcha; en caso contrario devuelve -1.