Timer QML Type

Déclenche un gestionnaire à un intervalle spécifié. En savoir plus...

• 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 minuteur peut être utilisé pour déclencher une action une seule fois ou de manière répétée à un intervalle donné.

Voici un minuteur 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 de minuterie est synchronisé avec la minuterie d'animation. Comme celle-ci est généralement réglée sur 60 images par seconde, la résolution de la minuterie 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 dont l’intervalle est de 1 000 ms est modifiée 500 ms après son démarrage, le temps écoulé sera remis à 0 et le Timer se déclenchera 1 000 ms plus tard.

Voir également la démo« Qt Quick » - Horloges.

Documentation sur les propriétés

interval : int

Définit l'interval e entre les déclencheurs, en millisecondes.

L'intervalle par défaut est de 1 000 millisecondes.

repeat : bool

Si la valeur de « repeat » est « true », le minuteur se déclenche de manière répétée à l'intervalle spécifié ; dans le cas contraire, il se déclenche une seule fois à l'intervalle spécifié, puis s'arrête (c'est-à-dire que la valeur de « running » est définie sur « false »).

repeat La valeur par défaut est « false ».

Voir également running.

running : bool

Si la valeur est « true », le minuteur démarre ; dans le cas contraire, il s'arrête. Pour un minuteur non récurrent, la valeur de « running » est définie sur « false » une fois que le minuteur a été déclenché.

running La valeur par défaut est « false ».

Voir également repeat.

triggeredOnStart : bool

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

Si la valeur de ` triggeredOnStart ` est `true`, le minuteur est déclenché immédiatement dès son démarrage, puis à l'intervalle spécifié. Notez que si `repeat` est défini sur `false`, le minuteur est déclenché deux fois : une fois au démarrage, puis à nouveau à l'intervalle spécifié.

triggeredOnStart La valeur par défaut est « false ».

Voir également « running ».

Documentation sur les signaux

triggered()

Ce signal est émis lorsque le délai du temporisateur est écoulé.

Documentation de la méthode

void restart()

Redémarre le chronomètre

Si le minuteur ne fonctionne pas, il sera lancé ; dans le cas contraire, il sera arrêté, réinitialisé à son état initial, puis relancé. La propriété « running » prendra la valeur « true » après un appel à « restart() ».

void start()

Lance le chronomètre

Si le chronomètre est déjà en cours, l'appel de cette méthode n'a aucun effet. La propriété « running » prendra la valeur « true » après un appel à « start() ».

void stop()

Arrête le chronomètre

Si le chronomètre ne fonctionne pas, l'appel de cette méthode n'a aucun effet. La propriété « running » prendra la valeur « false » après un appel à « stop() ».