ListLines

显示最近执行的脚本行.

ListLines , OnOff

参数

OnOff

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

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

Off: 在历史中略去后续执行的行.

[v1.1.30+]: 可以分别使用十进制值 1 和 0 代替 On 和 Off.

备注

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

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

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

[v1.1.28+]: 如果启用了 ListLines, 则内置变量 A_ListLines 将包含 1, 否则包含 0.

[v1.1.28] 之前的版本: 尽管没有内置变量 "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