Яндекс.Метрика

SetTimer -Autohotkey

Через заданные промежутки времени автоматически запускает подпрограмму.

Через заданные промежутки времени автоматически запускает подпрограмму.

SetTimer, Label [, Period|On|Off, Priority]

Параметры

Label Имя метки или метки горячей клавиши, к которой должна перейти программа. После этого исполняются все команды, находящиеся между Label и первой встретившейся командой Return (или Exit). Подобно параметрам почти всех других команд, Label может представлять собой ссылку на переменную, напр.: %MyLabel%. В этом случае строка, хранящаяся в этой переменной, используется в качестве имени метки.
Period|On|Off On: Разблокирует ранее заблокированный таймер, сохраняя прежний период. Если таймер не существует, он создается. При этом период устанавливается по умолчанию на 250.

Off: Блокирует существующий таймер.

Period: Создает или обновляет таймер. При этом данный параметр представляет собой количество миллисекунд, которые должны пройти с последнего запуска подпрограммы Label. По прошествии этого промежутка времени Label будет запущена снова (но только в том случае, если она закончила работу после предыдущего запуска). Таймер при этом будет автоматически разблокирован. Чтобы избежать разблокирования таймера, задайте команду SetTimer второй раз подряд, в качестве параметра определив OFF.

Если параметр не задан, и:
1) таймер не существует: он будет создан с периодом 250.
2) таймер уже существует: он будет разблокирован. Прежний период будет восстановлен, если не был задан параметр Priority.
Priority Этот необязательный параметр представляет собой целое число между числами -2147483648 и 2147483647 (или выражение), означающее приоритет потока данного таймера. Если параметр опущен, используется 0. См. Потоки.

Чтобы изменить приоритет существующего таймера, не затронув другие характеристики таймера, не задавайте предыдущий параметр.

Примечания

Таймеры удобны, поскольку запускаются асинхронно, т.е. запускаются с заданной частотой (через определенный интервал времени) даже в тех случаях, когда скрипт ожидает открытия окна, отображает диалог или занят выполнением другой задачи. Их можно использовать, например, для выполнения действий в то время, когда пользователь не работает (как показывает переменная %A_TimeIdle%) или для закрытия нежелательных окон в момент их появления.

Хотя таймеры могут создать впечатление того, что скрипт выполняет несколько задач одновременно, это не так. Напротив, спланированная по времени подпрограмма ведет себя точно так же, как и любой другой поток: она может прервать какой-либо поток или быть прерванной другим потоком, например таким, как подпрограмма горячей клавиши. См. Потоки.

Когда таймер блокируется, разблокируется или в нем задается новый период, он не запускается немедленно – сначала должен истечь заданный период времени. Если же вы хотите, чтобы исполнение началось тотчас же, задайте сразу же после команды SetTimer команду Gosub.

Точно так же, если команда SetTimer используется в уже существующем таймере, и вторым параметром является число или слово ON, то внутреннее "время последнего запуска" этого таймера будет установлено на текущее время. Другими словами, перед тем, как таймер запустится снова, должен пройти весь период времени полностью. Чтобы сбросить таймер, можно просто опустить все параметры, кроме первого. Например: SetTimer, TimerName. Однако в версиях, более ранних, чем 1.0.31, попытка сбросить таймер внутри его собственной подпрограммы/потока не даст никакого эффекта.

В настоящее время не существует возможности запускать таймеры чаще, чем каждые 10 миллисекунд в Windows XP/2000/NT и примерно каждые 55 миллисекунд в Windows 9x. Если задать меньший период, то таймер все равно будет запускаться с частотой, входящий в фактический интервал от 10 до 55 миллисекунд (впрочем, в будущих версиях положение может измениться, так что не стоит так уж полагаться на такое поведение).

Таймеры, в которых заданы очень короткие периоды, возможно, не смогут запускаться так часто, как предполагалось, в случае если текущие настойки SetBatchLines будут слишком сильно ограничивать скорость работы скрипта. Подобным образом, если общее количество исполняемых строк во всех спланированных по времени подпрограммах велико, вам, может быть, понадобится подкорректировать SetBatchLines, чтобы они смогли исполняться так часто, как это определено.

Таймер, возможно, не сможет запускаться с заданной частотой также в следующих случаях:

  1. Центральный процессор сильно загружен выполнением других приложений.
  2. Исполнение самой подпрограммы таймера занимает больше времени, чем период времени, заданный в этом таймере, или количество параллельных таймеров слишком велико (здесь может помочь корректирование SetBatchLines).
  3. Таймер был прерван другим потоком, а именно другой спланированной по времени подпрограммой, подпрограммой горячей клавиши или пунктом пользовательского меню. Если в этом случае для завершения прервавшего потока нужно много времени, то прерванный таймер будет заблокирован на продолжительное время. Однако другие таймеры продолжат исполняться, прерывая для этого тот поток, который прервал работу первого таймера.
  4. Скрипт нельзя прервать из-за команд Critical или Thread Interrupt/Priority. Все это время таймеры работать не будут. Позднее, когда скрипт вновь можно будет прервать, все задержавшиеся таймеры запустятся при первой представившейся возможности, а затем возобновят работу в соответствии с их обычным расписанием.

Поскольку таймеры функционируют, временно прерывая текущую активность скрипта, там, где долгая пауза нежелательна, подпрограммы таймеров должны быть короткими (чтобы их можно было быстро завершить).

Таймеры, которые действуют в течение всего времени исполнения скрипта, необходимо поместить в секцию авто-выполнения. В отличие от этого, временные таймеры часто может заблокировать их собственная подпрограмма (см. примеры в конце статьи).

При запуске спланированная по времени подпрограмма начинает свою работу заново со значений по умолчанию, которые задаются такими командами, как SendMode. Эти значения по умолчанию можно изменить в секции авто-выполнения.

Хотя таймеры продолжат функционировать, даже если работа скрипта будет приостановлена, это не относится к случаям, когда в текущем потоке действует "Thread NoTimers" или когда в работе потока сделана пауза. Они также не функционируют, когда пользователь осуществляет навигацию по меню иконки трея или по главному меню окон.

Если время отклика горячей клавиши важно (как, например, в играх), а в скрипте содержатся таймеры, подпрограммы которых исполняются дольше 5 миллисекунд, то чтобы избежать возможной задержки, используйте команду, приведенную ниже. В противном случае, подобная задержка может произойти при нажатии горячей клавиши в тот момент, когда поток таймера нельзя прервать:

Thread, interrupt, 0 ; Запрещаем прерывать все потоки при любых обстоятельствах.

Если таймер заблокирован во время исполнения подпрограммы, она продолжит свое исполнение до полного завершения.

Команда KeyHistory может показать количество существующих таймеров и количество таймеров, которые в данный момент разблокированы.

В версиях 1.0.36.03+, период таймера не может быть больше, чем 4294967295 миллисекунд (49,7 дней). В более ранних версиях предел составляет 2147483647 миллисекунд (24,8 дней).

Чтобы заставить скрипт, содержащий только таймеры, работать постоянно, используйте директиву #Persistent.

Примеры

; Пример №1: Закрытие нежелательных окон при их появлении: #Persistent SetTimer, CloseMailWarnings, 250 return CloseMailWarnings: WinClose, Microsoft Outlook, A timeout occured while communicating WinClose, Microsoft Outlook, A connection to the server could not be established return

; Пример №2: Ожидание появления определенного окна ; и последующее предупреждение об этом пользователя: #Persistent SetTimer, Alert1, 500 return Alert1: IfWinNotExist, Video Conversion, Process Complete return ; Иначе: SetTimer, Alert1, Off ; т.е. здесь таймер выключает себя сам. SplashTextOn, , , The video conversion is finished. Sleep, 3000 SplashTextOff return

; Пример №3: Определяет, сколько раз подряд была нажата горячая клавиша. ; В зависимости от количества выполненных нажатий варьируется и резуль- ; тат - выполняется первое, второе или третье задание соответственно: #c:: ;----------------------------------------------------- Block #2 --// ; Команда SetTimer уже запущена, но прежде, чем она сработает, ; мы успеем собрать данные о количестве нажатий наших горячих клавиш: If WinC_Presses > 0 { WinC_Presses += 1 Return } ;----------------------------------------------------- Block #1 --// ; А вот и наше первое нажатие горячих клавиш. Устанавливаем число нажатий ; равное 1 и запускаем таймер: WinC_Presses = 1 SetTimer, KeyWinC, 1000 ; Идет ожидание количества нажатий клавиш ; в течение 1000 миллисекунд. Return ;----------------------------------------------------- Block #3 --// KeyWinC: SetTimer, KeyWinC, Off ; отключение таймера. If WinC_Presses = 1 ; Если было всего одно нажатие горячих клавиш. { Run, C:\ ; Открывается папка C:\. } Else If WinC_Presses = 2 ; Если горячие клавиши нажимались дважды. { Run, D:\ ; Открывается другая папка - D:\. } Else If WinC_Presses > 2 { SplashTextOn, 400, 180, Зачем???, ( `n Вы нажали `n горячие клавиши `n три или более раз. `n`n А это запрещено! :) ) Sleep, 3000 SplashTextOff } ;----------------------------------------------------- Block #4 --// ; Вне зависимости от того, какое действие было выполнено, сбрасываем ; значение нашей переменной на ноль, чтобы подготовиться к следующей ; серии нажатий: WinC_Presses = 0 Return
Теги страницы: