Тип таймера 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 Demo - Часы.

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

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().