Тип QML Таймер

Вызывает обработчик через указанный интервал. Подробнее...

• Список всех членов, включая унаследованные

Свойства

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

Сигналы

• triggered()

Методы

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

Подробное описание

Таймер может использоваться для запуска действия один раз или многократно с заданным интервалом.

Вот таймер, который отображает текущую дату и время, обновляя текст каждые 500 миллисекунд. Он использует объект JavaScript Date для доступа к текущему времени.

import QtQuick 2.0

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

    Text { id: time }
}

Тип таймера синхронизирован с таймером анимации. Поскольку таймер анимации обычно настроен на 60 кадров в секунду, разрешение таймера будет в лучшем случае 16 мс.

Если таймер работает, и одно из его свойств изменено, прошедшее время будет сброшено. Например, если у таймера с интервалом 1000 мс свойство repeat изменено через 500 мс после запуска, прошедшее время будет сброшено до 0, и таймер сработает через 1000 мс.

См. также Демонстрация Qt Quick — Часы.

Документация по свойствам

interval : int

Устанавливает интервал между срабатываниями в миллисекундах.

Значение по умолчанию — 1000 миллисекунд.

repeat : bool

Если repeat имеет значение true, таймер срабатывает многократно с указанным интервалом; в противном случае таймер сработает один раз с указанным интервалом и остановится (т.е. running будет установлено в false).

Значение по умолчанию для repeat — false.

См. также running.

running : bool

Если установлено в true, запускает таймер; в противном случае останавливает таймер. Для не повторяющегося таймера running устанавливается в false после срабатывания таймера.

Значение по умолчанию для running — false.

См. также repeat.

triggeredOnStart : bool

Когда таймер запускается, первое срабатывание обычно происходит после истечения указанного интервала. Иногда желательно запустить срабатывание сразу же при запуске таймера; например, чтобы установить начальное состояние.

Если triggeredOnStart имеет значение true, таймер срабатывает сразу же при запуске и впоследствии с указанным интервалом. Обратите внимание, что если repeat установлено в false, таймер сработает дважды: один раз при запуске и ещё раз через интервал.

Значение по умолчанию для triggeredOnStart — false.

См. также running.

Документация по сигналам

triggered()

Этот сигнал генерируется, когда таймер отработал.

Примечание: Соответствующий обработчик — onTriggered.

Документация по методам

restart()

Перезапускает таймер

Если таймер не запущен, он запускается; в противном случае он останавливается, сбрасывается до начального состояния и запускается. Свойство running будет иметь значение true после вызова restart().

start()

Запускает таймер

Если таймер уже запущен, вызов этого метода не повлияет. Свойство running будет иметь значение true после вызова start().

stop()

Останавливает таймер

Если таймер не запущен, вызов этого метода не повлияет. Свойство running будет иметь значение false после вызова stop().