Timer QML Type
Activa un controlador a un intervalo especificado. Más información...
| 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 activar una acción, ya sea una sola vez o de forma repetida a intervalos determinados.
Aquí hay un temporizador que muestra la fecha y la 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 temporizador está sincronizado con el temporizador de animación. Dado que el temporizador de animación suele estar configurado a 60 fps, la resolución del temporizador será, como máximo, de 16 ms.
Si el temporizador está en marcha y se modifica una de sus propiedades, el tiempo transcurrido se reiniciará. Por ejemplo, si a un temporizador con un intervalo de 1000 ms se le modifica la propiedad «repeat» 500 ms después de iniciarse, el tiempo transcurrido se restablecerá a 0 y el temporizador se activará 1000 ms más tarde.
Véase también la demostración de «Qt Quick » - Relojes.
Documentación de propiedades
interval : int
Establece el « interval » entre disparos, en milisegundos.
El intervalo predeterminado es de 1000 milisegundos.
repeat : bool
Si « repeat » es «true», el temporizador se activa repetidamente en el intervalo especificado; en caso contrario, el temporizador se activará una vez en el intervalo especificado y luego se detendrá (es decir, «running» se establecerá en «false»).
repeat El valor por defecto es «false».
Véase también running.
running : bool
Si se establece en «true», inicia el temporizador; en caso contrario, lo detiene. En el caso de un temporizador no recurrente, la opción « running » se establece en «false» una vez que se ha activado el temporizador.
running El valor por defecto es «false».
Véase también repeat.
triggeredOnStart : bool
Cuando se inicia un temporizador, la primera activación suele producirse una vez transcurrido el intervalo especificado. En ocasiones, resulta conveniente que la activación se produzca inmediatamente al iniciar el temporizador; por ejemplo, para establecer un estado inicial.
Si « triggeredOnStart » es «true», el temporizador se activa inmediatamente al iniciarse y, posteriormente, en el intervalo especificado. Ten en cuenta que, si «repeat» se establece en «false», el temporizador se activa dos veces: una al iniciarse y otra en el intervalo.
triggeredOnStart El valor por defecto es «false».
Véase también running.
Documentación de Signal
triggered()
Esta señal se emite cuando el temporizador agota su tiempo de espera.
Nota: El controlador correspondiente es onTriggered.
Documentación del método
void restart()
Reinicia el temporizador
Si el temporizador no está en marcha, se pondrá en marcha; en caso contrario, se detendrá, se restablecerá a su estado inicial y se pondrá en marcha. La propiedad « running » será «true» tras una llamada a « restart() ».
void start()
Inicia el temporizador
Si el temporizador ya está en marcha, llamar a este método no tiene ningún efecto. La propiedad « running » pasará a ser «true» tras llamar a « start() ».
void stop()
Detiene el temporizador
Si el temporizador no está en marcha, llamar a este método no tiene ningún efecto. La propiedad « running » pasará a ser «false» tras llamar 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.