# 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 分别包含当前执行的行的编号和所属文件名.

## 相关

KeyHistory, ListHotkeys, ListVars

## 示例

显示最近执行的脚本行.

    ListLines

从历史记录中省略随后执行的脚本行.

    ListLines Off

dftg