QTimer Class

Documentation sur les fonctions membres

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

Construit un timer avec l'adresse parent.

[virtual noexcept] QTimer::~QTimer()

Détruit la minuterie.

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

Crée une connexion entre le signal timeout() de la minuterie et slot. Elle renvoie un identifiant pour la connexion.

Cette méthode est fournie pour des raisons de commodité. Elle est équivalente à un appel :

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

Voir aussi QObject::connect() et timeout().

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

Crée une connexion à partir du signal timeout() vers slot pour être placée dans une boucle d'événements spécifique de context, et renvoie une poignée vers la connexion.

Cette méthode est fournie pour des raisons de commodité. Elle est équivalente à l'appel :

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

Voir aussi QObject::connect() et timeout().

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

Retourne un Qt::TimerId représentant l'ID de la minuterie si la minuterie est en cours d'exécution ; sinon, retourne Qt::TimerId::Invalid.

Cette fonction a été introduite dans Qt 6.8.

Voir aussi Qt::TimerId.

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

Renvoie l'intervalle de ce timer sous la forme d'un objet std::chrono::milliseconds.

Voir aussi interval.

bool QTimer::isActive() const

Renvoie true si la minuterie est en cours ; sinon, renvoie false.

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

Renvoie le temps restant dans cet objet timer sous la forme d'un objet std::chrono::milliseconds. Si ce timer est échu ou en retard, la valeur renvoyée est std::chrono::milliseconds::zero(). Si le temps restant n'a pas pu être trouvé ou si le timer n'est pas en cours d'exécution, cette fonction renvoie une durée négative.

Voir également remainingTime().

Cette fonction statique appelle functor après interval.

Il est très pratique d'utiliser cette fonction car il n'est pas nécessaire de s'occuper de timerEvent ou de créer un objet local QTimer.

Si context est spécifié, alors functor ne sera appelé que si l'objet context n'a pas été détruit avant que l'intervalle ne se produise. Le foncteur sera alors exécuté dans le thread de context. Le thread du contexte doit avoir une boucle d'événements en cours d'exécution.

Si functor est une fonction membre de context, la fonction sera appelée sur l'objet.

Le paramètre interval peut être un int (interprété comme un compte en millisecondes) ou un type std::chrono qui convertit implicitement en nanosecondes.

À partir de Qt 6.10, la définition d'un intervalle négatif entraînera un avertissement à l'exécution et la réinitialisation de la valeur à 1ms. Avant Qt 6.10, un Qt Timer vous permettait de définir un intervalle négatif mais se comportait de manière surprenante (par exemple en arrêtant le timer s'il était en cours d'exécution ou en ne le démarrant pas du tout).

Note : Cette fonction est réentrante.

Voir aussi start().

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

Cette fonction statique appelle un slot après un intervalle de temps donné.

Il est très pratique d'utiliser cette fonction car il n'est pas nécessaire de s'embarrasser d'un timerEvent ou de créer un objet local QTimer.

L'objet receiver est l'objet récepteur et l'objet member est le slot. L'intervalle de temps est indiqué dans l'objet duration nsec.

À partir de Qt 6.10, la définition d'un intervalle négatif entraînera un avertissement lors de l'exécution et la réinitialisation de la valeur à 1ms. Avant Qt 6.10, un Qt Timer vous permettait de définir un intervalle négatif mais se comportait de manière surprenante (par exemple en arrêtant le timer s'il était en cours d'exécution ou en ne le démarrant pas du tout).

Note : Cette fonction est réentrante.

Voir aussi start().

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

Cette fonction statique appelle un slot après un intervalle de temps donné.

Il est très pratique d'utiliser cette fonction car il n'est pas nécessaire de s'embarrasser d'un timerEvent ou de créer un objet local QTimer.

L'objet receiver est l'objet récepteur et l'objet member est le slot. L'intervalle de temps est indiqué dans l'objet duration nsec. L'objet timerType affecte la précision de la minuterie.

À partir de Qt 6.10, la définition d'un intervalle négatif entraînera un avertissement lors de l'exécution et la réinitialisation de la valeur à 1 ms. Avant Qt 6.10, une minuterie Qt vous permettait de définir un intervalle négatif mais se comportait de manière surprenante (par exemple en arrêtant la minuterie si elle était en cours d'exécution ou en ne la démarrant pas du tout).

Note : Cette fonction est réentrante.

Voir aussi start().

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

Démarre ou redémarre la minuterie avec un intervalle de temps de msec millisecondes.

Cela équivaut à :

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

Si la minuterie est déjà en cours d'exécution, elle sera stopped et redémarrée. Cela modifiera également sa valeur id().

Si singleShot est vrai, la minuterie ne sera activée qu'une seule fois.

À partir de Qt 6.10, la définition d'un intervalle négatif entraînera un avertissement lors de l'exécution et la réinitialisation de la valeur à 1ms. Avant Qt 6.10, un Qt Timer vous permettait de définir un intervalle négatif mais se comportait de manière surprenante (par exemple en arrêtant le timer s'il était en cours d'exécution ou en ne le démarrant pas du tout).

// 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()

Démarre ou redémarre la minuterie avec le délai spécifié dans interval.

Si la minuterie est déjà en cours d'exécution, elle sera stopped et redémarrée. Cela modifiera également son id().

Si singleShot est vrai, la minuterie ne sera activée qu'une seule fois.

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

Démarre ou redémarre la minuterie avec un délai d'attente d'une durée de interval millisecondes.

Cela équivaut à :

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

Si la minuterie est déjà en cours d'exécution, elle sera stopped et redémarrée. Cela modifiera également son id().

Si singleShot est vrai, la minuterie ne sera activée qu'une seule fois.

À partir de Qt 6.10, la définition d'un intervalle négatif entraînera un avertissement lors de l'exécution et la réinitialisation de la valeur à 1ms. Avant Qt 6.10, un Qt Timer vous permettait de définir un intervalle négatif mais se comportait de manière surprenante (par exemple en arrêtant le timer s'il était en cours d'exécution ou en ne le démarrant pas du tout).

[slot] void QTimer::stop()

Arrête la minuterie.

Voir également start().

[private signal] void QTimer::timeout()

Ce signal est émis lorsque la minuterie s'arrête.

Voir aussi interval, start(), et stop().

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

Réimplémente : QObject::timerEvent(QTimerEvent *event).

int QTimer::timerId() const

Renvoie l'ID du timer si le timer est en cours d'exécution, sinon renvoie -1.