关 键 字 参 考

#include

包含指定的外部文件到脚本中.

#include "[路径\]文件名"
#include <文件名>

参 数

文件名 包含到当前脚本的文件名, 路径可选. 文件名必须是字符串, 不能是变量.
如果使用双引号 "...", 将从当前脚本目录开始查找该文件
如果使用尖括号 <...>, 将从包含文件库目录中查找该文件.
(通常汉化版默认安装的库包含文件目录为 E:\AutoIt3\Include).
包含文件库目录中有许多预定义的用户函数!

备 注

在 AutoIt 的脚本中,可通过 "#include" 命令包含其它脚本文件.

如果用户函数(脚本)重复包含同一文件, 将出现 "Duplicate function"(重复函数) 错误.
编写包含文件时最好在首行添加一句 #include-once, 以避免文件被重复包含.

有一个注册表值,创建于 "HKEY_CURRENT_USER\Software\AutoIt v3\AutoIt"
名称为 "Include". 应该是 REG_SZ (string) 值.
值的内容是一个分号分隔的目录列表,可供解析 #include 时搜索文件的标准位置.

搜索次序依赖于 AutoIt 使用 #include 的格式. 下面表格是两种使用 #include 形式时的搜寻次序.

使用 #include <...>
标准库 在解释程序(AUTOIT3.EXE)所在目录下面的 "\Include" 目录中搜索.
用户自定义库 在上述注册表中顺序搜索.
脚本目录 在当前执行脚本的目录中搜索.

使用 #include "..." (和 #include <...> 相反).
脚本目录 在当前执行脚本的目录中搜索
用户自定义库 在上述注册表中反序搜索.
标准库 在解释程序(AUTOIT3.EXE)所在目录下面的 "\Include" 目录中搜索.

关于使用 /AutoIt3ExecuteScript 选项的说明.
由于标准库的搜索是在当前解释程序的目录中, 标准库函数将不会被发现; 该库将只能通过运行 AutoIt3.exe 时才能发现.
因此建议将脚本编译为 .a3x 格式, 然后再尝试以 /AutoIt3ExecuteScript 运行它.

Aut2Exe 和 AutoIt3.exe 运行时原理基本相同, 惟一不同的是可以在包含子目录时同时包含自身目录的文件 (..\Include).

如果设置 Opt("TrayIconDebug",1), 则只有 64 个包含文件名可以显示在托盘工具提示中, 其它文件名将不会显示.

相 关 函 数

#include-once

函 数 示 例


;;; SCRIPT.AU3 ;;;
MsgBox(0, "", "示例")
#include "include-TIME.AU3"
Exit

; 运行脚本将输出两个消息框: 首先是 "示例", 其次是当前时间信息.

provider with jb51.net (unicode)