Тип таймера 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().