SetTimer

优质

小牛编辑

139浏览

2023-12-01

以指定的时间间隔自动并重复运行子程序。

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

参数

标签

跳转的目标标签或热键标签的名称, 这样会执行 Label 下的命令, 直到遇到 Return 或 Exit. 和几乎其他所有命令的参数一样, Label 可以为变量引用 (例如 %MyLabel%), 此时将使用变量中的名称作为跳转的目标.

[v1.1.01+]: 如果省略 Label, 则使用 A_ThisLabel. 例如, SetTimer,, Off 可以用来在定时子程序中关闭计时器.

Period|On|Off

On: 以原来的周期重新启用之前禁用的计时器. 如果计时器不存在, 则进行创建 (使用默认的周期 250). 如果计时器存在但之前被设为单次运行模式, 那么它仍然只运行一次.

Off: 禁用现有的计时器.

周期: 把此参数作为上次 Label 子程序启动后必须经过的近似的毫秒数来创建或更新计时器. 经过了这个指定的时间值后, 会再次运行 Label (除非自上次启动后仍在运行中). 会自动启用计时器. 要避免这种情况, 紧接着再次使用此命令, 指定此参数为 OFF.

如果此参数为空并且:
1) 计时器不存在: 则使用 250 的周期进行创建.
2) 计时器已经存在: 则启用计时器并重设为它原来的周期 (除非指定了 Priority).

单次运行 [v1.0.46.16+]: 使用负的周期来表示计时器只运行一次. 例如，指定 -100 将会从现在开始的 100 ms 后运行计时器，然后就像使用 SetTimer, Label, Off 那样禁用计时器。

Priority

这个可选参数是一个介于 -2147483648 和 2147483647 之间的整数 (或为表达式) 来表示计时器的优先级. 如果省略, 则使用 0. 请参阅线程了解详情.

要改变现有计时器的优先级而不影响其他方面, 请留空前一个参数.

备注

计时器很有用, 因为它们是异步运行的, 这意味着它们会以指定的频率 (间隔) 运行, 即使脚本正等待窗口, 显示对话框或忙于其他任务的时候. 它们的许多应用实例包括了当用户空闲时 (如 A_TimeIdle 反映的那样) 执行一些动作或在不需要的窗口出现时关闭它们.

尽管计时器给人一种脚本同时执行多个任务的错觉, 实际并非如此. 相反地, 定时子程序只是被当作其他线程来处理: 它们可以中断另一个线程或被另一个线程中断, 例如热键子程序. 请参阅线程了解详情.

每当创建或重新启用计时器或用新的周期更新计时器时，它的子程序都不会立即运行，必须先经过它的周期时间。如果您希望立即开始计时器的首次执行, 请使用 Gosub 来执行计时器的子程序 (但是, 这种方式不会像计时器那样启动新线程; 所以诸如 SendMode 的设置不会以它们的默认值开始).

如果 SetTimer 用于现有的计时器且第二个参数为数字或单词 ON (或省略), 则计时器内部的 "上次运行的时间" 会被重置为当前时间; 换句话说, 在经过它的整个周期后子程序才会再次运行.

计时器精度: 由于操作系统中计时系统的精确度, 周期通常会被向上取整到最近的 10 或 15.6 毫秒的倍数 (取决于所安装的硬件和驱动的类型). 例如，在 Windows NT/2000/XP 中介于 1 和 10（含边界）的周期通常相当于 10 或 15.6。使用 Loop+Sleep 可以实现更短的延时, 请参阅演示: DllCall+timeBeginPeriod+Sleep.

计时器在下列情况中可能无法按指定频率运行:

其他程序让 CPU 负载较大.
定时子程序运行的时间超过它自己的周期, 或者有太多竞争计时器 (改变 SetBatchLines 可能有帮助).
计时器已经被另一个线程中断, 即另一个定时子程序, 热键子程序或自定义菜单项 (这可以使用 Critical 避免). 如果这种情况发生了并且中断的线程花费了很长的时间才结束, 则被中断的计时器在这段时间里会被禁用. 不过, 其他任何计时器会对这个中断首个计时器的线程进行中断来继续运行.
使用 Critical 或 Thread Interrupt/Priority 后脚本会变成不可中断的. 在这样的时期, 计时器不会运行. 之后, 当脚本恢复可中断时, 任何过时的计时器会尽快运行一次然后恢复到正常的调度.

尽管计时器在脚本挂起时仍会运行, 但是如果当前线程的 "Thread NoTimers" 正在起作用或者任意线程被暂停时则不会. 此外, 当用户通过脚本的菜单 (例如托盘图标菜单或菜单栏) 进行导航时它们也不会运行.

因为计时器是通过临时中断脚本当前线程来运行的, 所以它们的子程序应该保持简短 (以便很快地结束), 无论何时很长的中断都是不好的.

要在脚本运行期间保持有效的计时器一般应在自动执行段中进行创建. 与之相比, 临时的计时器经常可以在它自己的子程序中禁用 (请参阅此页面底部的示例).

每当计时子程序运行时，它会使用设置（例如 SendMode）的默认值开始。这些默认值可以在自动执行段改变.

如果热键的响应时间非常重要 (例如在游戏中) 且脚本包含了子程序执行时间超过 5 ms 的计时器, 那么请使用下列命令来避免 15 ms 的延迟. 如果在热键按下时恰好处于计时器线程的不可中断期间, 那么这样的延迟还是会发生.

Thread, interrupt, 0  ; 让所有的线程总是不可中断的.

如果计时器在它的子程序正运行时被禁用, 那么该子程序会继续运行直到完成.

KeyHistory 功能会显示存在的计时器数目以及当前启用的数目.

计时器的周期不能大于 4294967295 毫秒 (49.7 天).

要让脚本持续运行 (例如只包含计时器的脚本), 请使用 #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
; Otherwise:
SetTimer, Alert1, Off  ; 即此处计时器关闭自己.
SplashTextOn, , , The video conversion is finished.
Sleep, 3000
SplashTextOff
return

; 示例 #3: 检测热键的单次, 两次和三次按下. 这样
; 允许热键根据您按下次数的多少
; 执行不同的操作：
#c::
if winc_presses > 0 ; SetTimer 已经启动, 所以我们记录键击.
{
    winc_presses += 1
    return
}
; 否则, 这是新开始系列中的首次按下. 把次数设为 1 并启动
; 计时器：
winc_presses = 1
SetTimer, KeyWinC, 400 ; 在 400 毫秒内等待更多的键击.
return

KeyWinC:
SetTimer, KeyWinC, off
if winc_presses = 1 ; 此键按下了一次.
{
    Run, m:\  ; 打开文件夹.
}
else if winc_presses = 2 ; 此键按下了两次.
{
    Run, m:\multimedia  ; 打开不同的文件夹.
}
else if winc_presses > 2
{
    MsgBox, Three or more clicks detected.
}
; 不论触发了上面的哪个动作, 都对 count 进行重置
; 为下一个系列的按下做准备:
winc_presses = 0
return

SetTimer

参数

备注

相关

示例