Is Clock Running
QuartzClockHandleЧто это
Pure-функция (без exec-пинов), которая возвращает true, если кварцевый таймер (QuartzClockHandle) в данный момент активен (отсчитывает время), и false, если он остановлен, завершён или ещё не был запущен. Полезна для проверки состояния таймера перед его остановкой, изменением параметров или в условных ветках логики.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные): _(не уверен в точной сигнатуре)_
Выходы (данные): _(не уверен в точной сигнатуре)_
Когда используется
- Проверка, работает ли таймер, перед вызовом
StopClockилиPauseClock(чтобы не остановить уже остановленный). - Ветвление логики в зависимости от того, идёт ли отсчёт времени (например, показывать/скрывать индикатор).
- Защита от повторного запуска уже работающего таймера.
Типичные проблемы
- Ложное предположение о завершении:
IsClockRunningвозвращаетfalseи для остановленного, и для завершённого таймера. Если нужно различать эти состояния, используйтеGetRemainingTimeилиGetTotalDuration. - Недействительный handle: вызов на уничтоженном или неинициализированном
QuartzClockHandleприведёт к ошибке выполнения. Всегда проверяйте, что handle получен отCreateClockилиGetClock. - Гонка состояний: между проверкой
IsClockRunningи следующим действием таймер может успеть завершиться. Для критичных сценариев используйте события (OnTimerComplete).