Timer QML Type
Activa un controlador en un intervalo especificado. Más...
| Import Statement: | import QtQml |
Propiedades
- interval : int
- repeat : bool
- running : bool
- triggeredOnStart : bool
Señales
Métodos
Descripción detallada
Un temporizador se puede utilizar para desencadenar una acción, ya sea una vez, o repetidamente en un intervalo determinado.
Este es un temporizador que muestra la fecha y hora actuales y actualiza el texto cada 500 milisegundos. Utiliza el objeto JavaScript Date para acceder a la hora actual.
import QtQuick 2.0 Item { Timer { interval: 500; running: true; repeat: true onTriggered: time.text = Date().toString() } Text { id: time } }
El tipo Timer está sincronizado con el temporizador de animación. Dado que el temporizador de animación suele estar configurado a 60fps, la resolución del Timer será como mucho de 16ms.
Si el Temporizador está funcionando y se cambia una de sus propiedades, el tiempo transcurrido se reiniciará. Por ejemplo, si un Temporizador con intervalo de 1000ms tiene su propiedad de repetición cambiada 500ms después de empezar, el tiempo transcurrido se reiniciará a 0, y el Temporizador se disparará 1000ms más tarde.
Ver también Qt Quick Demo - Relojes.
Documentación de Propiedades
interval : int
Establece el interval entre disparos, en milisegundos.
El intervalo por defecto es de 1000 milisegundos.
repeat : bool
Si repeat es verdadero, el temporizador se activará repetidamente en el intervalo especificado; de lo contrario, el temporizador se activará una vez en el intervalo especificado y luego se detendrá (es decir, la ejecución se establecerá en falso).
repeat por defecto es false.
Véase también running.
running : bool
Si se establece en true, inicia el temporizador; en caso contrario, lo detiene. Para un temporizador no repetitivo, running se establece en false después de que se haya disparado el temporizador.
running por defecto a false.
Véase también repeat.
triggeredOnStart : bool
Cuando se inicia un temporizador, el primer disparo suele producirse una vez transcurrido el intervalo especificado. A veces es deseable que el temporizador se active inmediatamente cuando se inicia; por ejemplo, para establecer un estado inicial.
Si triggeredOnStart es verdadero, el temporizador se activa inmediatamente cuando se inicia, y posteriormente en el intervalo especificado. Tenga en cuenta que si la repetición es falsa, el temporizador se activa dos veces: una al iniciarse y otra en el intervalo.
triggeredOnStart por defecto es false.
Véase también running.
Documentación de señales
triggered()
Esta señal se emite cuando el temporizador se agota.
Nota: El manejador correspondiente es onTriggered.
Documentación del método
void restart()
Reinicia el temporizador
Si el temporizador no está en marcha, se iniciará; en caso contrario, se detendrá, se restablecerá al estado inicial y se iniciará. La propiedad running será verdadera tras una llamada a restart().
void start()
Inicia el temporizador
Si el temporizador ya está en marcha, la llamada a este método no tiene ningún efecto. La propiedad running será verdadera después de una llamada a start().
void stop()
Detiene el temporizador
Si el temporizador no está en marcha, la llamada a este método no tiene ningún efecto. La propiedad running será falsa tras una llamada a stop().
© 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.