Keyword Reference

 首页  后退  前进

#include

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

 

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

#include <文件名>

参数

文件名

包含到当前脚本的文件名, 路径可选. 文件名必须是字符串, 不能是变量.

如果使用双引号 "...", 将从当前脚本目录开始查找该文件

如果使用尖括号 <...>, 将从包含文件库目录中查找该文件.

(通常汉化版默认安装的库包含文件目录为 E:AutoIt3Include).

包含文件库目录中有许多预定义的用户函数!

备注

其它脚本可以使用 #include 命令包含到一个 AutoIt 脚本中 - 这些可以是 .au3 或 .a3x 格式.

包含文件的内容在 "#include" 命令点插入到脚本 - 大多数情况下是在脚本的开头, 以便包含文件内声明的变量或常量在脚本的其它部分可用.

 

如果重复包含同一用户函数(脚本)文件, 将出现 "Duplicate function"(重复函数) 错误.

编写包含文件时最好在首行添加一句 #include-once, 以避免文件被重复包含.

 

有一个特殊的注册表值,创建于 "HKEY_CURRENT_USER\Software\AutoIt v3\AutoIt"

名称为 "Include". 应该是 REG_SZ (字符串) 值.

值的内容是一个分号分隔的目录列表,可供搜索 #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

函数示例

#include "include-TIME.au3"
MsgBox($MB_SYSTEMMODAL, "", "Example")
#include <MsgBoxConstants.au3>
Exit
; Running script.au3 will output two message boxes:
; one with 'Example', followed by one with the time.

----------------------------------------