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