Тип 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 }
}

Тип Timer синхронизирован с таймером анимации. Поскольку таймер анимации обычно настроен на 60 кадров в секунду, разрешение Timer будет, в лучшем случае, 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().