ListLines

优质

小牛编辑

130浏览

2023-12-01

显示最近执行的脚本行。

ListLines [, On|Off]

参数

On|Off

如果为空或省略, 则显示最近执行的脚本行的历史. 在 v1.0.48.01+, 添加了可选的首个参数, 可以为 On 或 Off. 它只影响当前线程的行为, 说明如下:

On：包括历史中后续执行的行。对于所有的脚本这是初始默认值.

Off：在历史中略去后续执行的行。

备注

ListLines (不带参数) 等同于在主窗口中选择了 "View->Lines most recently executed" 菜单项. 可用于调试脚本。

ListLines Off/On 可用来选择性的从历史中略去一些行，这样有助于避免历史被过快填满（例如在含许多快速重复的循环中）。ListLines Off 还可以提升一些脚本的性能。

每个新运行的线程 (例如热键, 自定义菜单项或定时子程序) 都会以此命令的默认设置开始. 通过在脚本的自动执行段 (脚本的顶部) 使用此命令可以改变这个默认设置.

尽管没有内置变量 "A_ListLines", 但在脚本中使用下列语句可以实现相同的功能:

ListLines(PassTrueToTurnOnOrFalseToTurnOff)  ; 返回 ListLines 之前的设置 (在此调用之前).
{
    static sListLines := true  ; 对于所有的脚本的初始默认设置为 "ListLines On".
    ListLines % PassTrueToTurnOnOrFalseToTurnOff ? "On" : "Off"  ; 无条件执行 ListLines 来略去日志还未执行的行.
    ListLines_prev := sListLines
    sListLines := PassTrueToTurnOnOrFalseToTurnOff
    return ListLines_prev
}

; 使用上面的函数:
prev_ListLines := ListLines(false)  ; 临时关闭 ListLines.
; ...
ListLines(prev_ListLines)  ; 恢复 ListLines 到原来的设置.

相关提示, 内置变量 A_LineNumber 和 A_LineFile 分别包含当前执行的行的编号和所属文件名.

示例

ListLines
ListLines Off