ListLines

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

PrevSetting := ListLines(Setting)

参数

Setting

类型: 整数(布尔值)

如果省略, 则显示最近执行的脚本行的历史, 这相当于在主窗口中选择相应的菜单项. 这有助于调试脚本.

否则, 请指定以下其中一个数字来禁用或启用行日志记录:

0(false): 禁用行日志记录功能, 这意味着后续执行的行将不会被包含在历史记录中.

1(true): 启用行日志.

返回值

整数: 整数(布尔值)

函数返回以前的设置: 0(false) 表示禁用或 1(true) 表示开启.

备注

默认情况下, 开启行历史记录.

有选择地禁用行日志记录功能有助于防止历史记录过快积累, 例如在包含大量快速迭代的循环中. 禁用/启用行日志记录的那行也会从行历史记录中删除, 以避免造成混乱. 此外, 启用行日志记录后, 性能可能会降低几个百分点.

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

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

内置变量 A_ListLines 包含了当前的设置, 并且还可以重新设定一个值, 而无需调用 ListLines.

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

相关

KeyHistory, ListHotkeys, ListVars

示例

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