Timer QML Type

Déclenche un gestionnaire à un intervalle spécifié. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• interval : int
• repeat : bool
• running : bool
• triggeredOnStart : bool

Signaux

• triggered()

Méthodes

• void restart()
• void start()
• void stop()

Description détaillée

Un Timer peut être utilisé pour déclencher une action soit une seule fois, soit de manière répétée à un intervalle donné.

Voici un Timer qui affiche la date et l'heure actuelles et met à jour le texte toutes les 500 millisecondes. Il utilise l'objet JavaScript Date pour accéder à l'heure actuelle.

import QtQuick 2.0

Item {
    Timer {
        interval: 500; running: true; repeat: true
        onTriggered: time.text = Date().toString()
    }

    Text { id: time }
}

Le type Timer est synchronisé avec le timer d'animation. Comme le timer de l'animation est généralement réglé sur 60 images par seconde, la résolution du Timer sera au mieux de 16 ms.

Si le Timer est en cours d'exécution et que l'une de ses propriétés est modifiée, le temps écoulé sera réinitialisé. Par exemple, si la propriété repeat d'un Timer avec un intervalle de 1000ms est modifiée 500ms après son démarrage, le temps écoulé sera remis à 0 et le Timer sera déclenché 1000ms plus tard.

Voir également Qt Quick Demo - Clocks.

Documentation sur les propriétés

interval : int

Définit l'intervalle interval entre les déclenchements, en millisecondes.

L'intervalle par défaut est de 1000 millisecondes.

repeat : bool

Si repeat est vrai, la minuterie est déclenchée de manière répétée à l'intervalle spécifié ; sinon, la minuterie se déclenche une fois à l'intervalle spécifié, puis s'arrête (c'est-à-dire que la valeur "running" est fixée à false).

repeat La valeur par défaut est false.

Voir aussi running.

running : bool

S'il vaut true, il démarre la minuterie ; sinon, il l'arrête. Dans le cas d'une minuterie non répétitive, running est défini sur false après le déclenchement de la minuterie.

running La valeur par défaut est false.

Voir également repeat.

triggeredOnStart : bool

Lorsqu'une minuterie est lancée, le premier déclenchement a généralement lieu après l'écoulement de l'intervalle spécifié. Il est parfois souhaitable de déclencher immédiatement la minuterie, par exemple pour établir un état initial.

Si triggeredOnStart est vrai, la minuterie est déclenchée immédiatement lorsqu'elle est démarrée, puis à l'intervalle spécifié. Notez que si repeat vaut false, la minuterie est déclenchée deux fois : une fois au démarrage et une autre fois à l'intervalle spécifié.

triggeredOnStart est défini par défaut sur false.

Voir également running.

Documentation sur les signaux

triggered()

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

Documentation de la méthode

void restart()

Redémarrage de la minuterie

Si la minuterie n'est pas en cours d'exécution, elle sera démarrée, sinon elle sera arrêtée, remise à l'état initial et démarrée. La propriété running sera vraie à la suite d'un appel à restart().

void start()

Démarre la minuterie

Si la minuterie est déjà en cours d'exécution, l'appel à cette méthode n'a aucun effet. La propriété running sera vraie à la suite d'un appel à start().

void stop()

Arrête la minuterie

Si la minuterie n'est pas en cours d'exécution, l'appel à cette méthode n'a aucun effet. La propriété running sera fausse à la suite d'un appel à stop().