# ListLines

启用或禁用行日志记录或显示最近执行的脚本行.

    ListLines Mode

## 参数

Mode

  类型: 整数

  如果省略, 则显示最近执行的脚本行的历史. 否则, 请指定以下值之一, 这仅影响当前线程的行为, 如下所示:

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

  `0` 或 `False`: 从历史中略去后续执行的行.

## 返回值

整数: 整数

函数返回以前的设置.

## 备注

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

`ListLines Mode` 可用来选择性的从历史中略去一些行, 这样有助于避免历史被过快填满(例如在含许多快速重复的循环中). 为了防止混乱, 调用 ListLines 的行也从行历史中删除了. 此外, 启用行日志记录后, 性能可能会降低几个百分点.

当改变 ListLines 模式时, 当前行(通常是调用 ListLines 或|赋值给 A_ListLines 的行) 将从行历史中删除.

每个新运行的线程(如 热键, 自定义菜单项或定时子程序) 都会以此函数的默认设置开始. 这个默认设置可以通过在脚本启动中使用此函数来改变.

如果启用了 ListLines, 则内置变量 A_ListLines 包含 1, 否则包含 0.

相关说明, 内置变量 A_LineNumber 和 A_LineFile 包含当前执行的行号及其所属的文件名.

## 相关

KeyHistory, ListHotkeys, ListVars

## 示例

启用和禁用特定行的行记录, 然后显示结果.

    x := "This line is logged"
    ListLines False
    x := "This line is not logged"
    ListLines True
    ListLines
    MsgBox

dftg