基 础 函 数 参 考


AutoItSetOption

调整 Autoit 函数或参数的操作方式.

AutoItSetOption ( "选项" [, 参数] )

参 数

选项 要修改的选项. 见备注.
参数 [可选函数] 分配给选项的值. 因选项的不同而类型与意义不同, 见备注.
如果不提供参数值, 则函数仅返回已分配给选项的值.
关键字 Default 用于将选项的参数重置为默认值.

返 回 值

成功: 返回先前设置的选项值.
失败: 设置 @error 为非 0, 函数失败可能由于参数无效(如选项不存在).

备 注

可以使用 Opt() 代替 AutoItSetOption().

选项与参数列举如下:


选项 参数
CaretCoordMode 设置 caret(插入符)函数的坐标更新方式, 坐标值均相对于当前激活窗口:
0 = 激活窗口的相对坐标
1 = 绝对屏幕坐标 (默认)
2 = 激活窗口客户区的相对坐标
ExpandEnvStrings 更改字符串和 % 符号的字面解释方式. 默认字符串按原文解释.
此选项允许在字符串中使用形如 %environment% 的环境变量, 例如 "临时文件夹路径: %temp%".
1 = 展开环境变量(类似于 AutoIt v2)
0 = 不展开展环境变量(默认)
若不设置此选项, 则实现类似功能的方法是: "临时文件夹路径: " & EnvGet("temp")
ExpandVarStrings 更改字符串和变量/宏 ($ and @) 符号的字面解释方式. 默认字符串按原文解释.
此选项允许在字符串中使用变量和宏,例如, "变量的值是 $var1$".
1 = 展开变量. 在此模式下如果要表示 $ 或 @ 本身, 则请用连续两个相应符号表示, 例如:"这里有一个美元符号 $$".
0 = 不展开变量(默认)
GUICloseOnESC 在 GUI 窗口按下 ESC 键, 则将发送 $GUI_EVENT_CLOSE (关闭)消息. 此选项用以切换这一行为.
1 = 按下 ESC 时发送 $GUI_EVENT_CLOSE (关闭)消息 (默认).
0 = 按下 ESC 时不发送 $GUI_EVENT_CLOSE (关闭)消息.
GUICoordMode 修改 GUICtrlSetPos 函数的坐标参照.
1 = 相对于对话框的绝对坐标(默认).
0 = 相对于上一个控件的起始位置(左上角).
2 = 相对于当前位置的坐标. -1 开始于左或上端的坐标, 且不递增.
因此, 下一行是 -1, 偏移量; 下一单元格偏移,-1; 当前单元格是 -1,-1.
显然, "offset" 不能是 -1, 保留此值表明没有增量. 但如果使用多种宽度, 可以选择跳过或返回.
GUIDataSeparatorChar 定义 GUICtrlSetData 函数多个数据间的分隔字符.
 默认分隔字符为 '|'.
GUIOnEventMode 启用/禁用 OnEvent 事件函数通知.
0 = 禁用(默认).
1 = 启用.
GUIResizeMode 更改控件大小调整的模式.
0 = (默认) 保持控件的默认大小.
<1024 = 任何类型的大小, 详情请查看 GUICtrlSetResizing.
GUIEventOptions 修改特殊事件行为或 GUI 函数的返回值.
0 = (默认) 允许窗口的点击行为: 最小化, 还原, 最大化, 改变大小.
1 = 禁止窗口最小化, 最大化, 还原, 改变大小等的点击行为; 仅发送通知.
MouseClickDelay 修改鼠标连续点击之间的停顿时间.
以毫秒为单位 (默认=10).
MouseClickDownDelay 修改按键释放之前按住按钮的时间.
以毫秒为单位 (默认=10).
MouseClickDragDelay 修改鼠标拖动操作的开始到结束之间的时间.
以毫秒为单位 (默认=250).
MouseCoordMode 设置鼠标函数的 coords 坐标参照, 坐标值均相对于当前激活窗口:
0 = 激活窗口的相对坐标
1 = 绝对屏幕坐标 (默认)
2 = 激活窗口客户区的相对坐标
MustDeclareVars 如果设置了此选项, 则所有变量在使用之前必须先使用 Dim / Local / Global 声明
这将有助于减少拼写错误造成变量错误的机会.
1 = 变量必需预先声明
0 = 变量不需预先声明 (默认)
PixelCoordMode 设置象素函数的 coords 坐标参照, 坐标值均相对于句柄定义的窗口 (默认为激活窗口):
0 = 定义窗口的相对坐标
1 = 绝对屏幕坐标 (默认)
2 = 定义窗口客户区的相对坐标
SendAttachMode 指定使用 Send() 函数时 AutoIt 是否捆绑( attach )输入线程.
当不捆绑(默认模式=0)时, 检测 capslock/scrolllock 与 numlock 的状态可能不准确(在 NT4).
不过, 在设置捆绑模式 = 1 时, Send("{... down/up}") 语句将不工作, 并且发送按键时也可能会导致系统挂起等问题.
ControlSend() 函数则总是捆绑线程的, 而且不受此模式设置的影响.
0 = 不捆绑 (默认)
1 = 捆绑
SendCapslockMode 指定 AutoIt 执行 Send 函数之前,是否保存大小写切换键(CapsLock)的状态, 并在完成操作后恢复原来的状态.
0 = 不保存/恢复
1 = 保存并恢复 (默认)
SendKeyDelay 更改发送键击命令之间的延迟时间长度. 值为 0 时完全消除延迟.
以毫秒为单位(默认=5).
SendKeyDownDelay 修改一键被按下之前, 等待按键释放的时间长度.
对于需要花费一定时间才能注册键击的程序, 可能需要提高默认值.
值为 0 则完全消除延迟.
以毫秒为单位(默认=5).
TCPTimeout 定义 TCP 函数连接时最大延迟时间(超过就不再连接).
以毫秒为单位(默认=100).
TrayAutoPause 单击托盘图标时脚本是否暂停.
0 = 不暂停
1 = 暂停 (默认). 如果没有 DefaultMenu, 暂停不会发生.
TrayIconDebug 启用托盘图标提示当前脚本执行的行号,用于帮助调试.
0 = 不显示调试信息 (默认)
1 = 显示调试信息
TrayIconHide 隐藏 AutoIt 托盘图标. 注意: 托盘图标仍会在刚运行时出现大约 750 毫秒.
0 = 显示托盘图标 (默认)
1 = 隐藏托盘图标
TrayMenuMode 扩展脚本的托盘图标/菜单性能. 可以是以下值的组合.
0 = 默认菜单项目(脚本暂停中.../退出) 附加到用户创建的菜单; 用户创建的选中项目自动取消选中;
如果双击系统托盘图标, 则控件 ID 返回默认样式 (默认).
1 = 没有默认菜单
2 = 如果点击用户创建的选中项目, 不会自动取消选中状态
4 = 双击系统托盘图标不返回菜单项目 ID 的默认行为
8 = 关闭单选项目组的自动单选
TrayOnEventMode 启用/禁用托盘 OnEvent 事件函数通知.
0 = (默认) 禁用
1 = 启用
WinDetectHiddenText 指定是否让隐藏的窗口文本也能被窗口匹配函数检测.
0 = 不检测隐藏文本 (默认)
1 = 检测隐藏文本
WinSearchChildren 允许窗口搜索程序搜索子窗口以及顶层窗口.
0 = 仅搜索顶层窗口 (默认)
1 = 搜索顶层窗口及子窗口
WinTextMatchMode 修改窗口函数执行搜索时的窗口文本匹配模式.
1 = 完全匹配 / 慢速模式 (默认)
2 = 快速模式
快速模式下,AutoIt 通常只能"看见"对话框文本, 按钮文本和某些控件的标题.
而在默认模式下则能检测到更多的文本(例如记事本窗口的内容).
如果在执行较多窗口的搜索操作时遇到性能(指速度)问题, 应该考虑使用快速模式.
WinTitleMatchMode 修改窗口函数执行搜索时的标题匹配模式.
1 = 匹配标题的开始部分 (默认)
2 = 匹配标题的任意子串
3 = 完全匹配标题
4 = 高级模式,详情请查看 窗口标题与文本 (高级)
-1 到 -4 = 强制根据类型匹配小写字母.
WinWaitDelay 修改成功执行窗口相关操作后的延迟时间长度.
以毫秒为单位(默认=250).

相 关 函 数

Many!

函 数 示 例


;复制任何你想要修改的代码   首先列出的为该代码的默认值

Opt("CaretCoordMode", 1) ;1=绝对坐标, 0=相对坐标, 2=客户区坐标
Opt("ExpandEnvStrings", 0) ;0=不展开, 1=展开
Opt("ExpandVarStrings", 0) ;0=不展开, 1=展开
Opt("GUICloseOnESC", 1) ;1=点击 ESC 发送关闭消息, 0=点击 ESC 不发送关闭消息
Opt("GUICoordMode", 1) ;1=绝对坐标, 0=相对坐标, 2=相对于当前位置的坐标
Opt("GUIDataSeparatorChar", "|") ;默认分隔符 " | "
Opt("GUIOnEventMode", 0) ;0=禁用 OnEvent 事件模式, 1=启用 OnEvent 事件模式
Opt("GUIResizeMode", 0) ;0=不调整大小, <1024 特定的调整大小
Opt("GUIEventOptions", 0) ;0=默认, 1=只是通知, 2=GuiCtrlRead 选项卡索引
Opt("MouseClickDelay", 10) ;10 毫秒
Opt("MouseClickDownDelay", 10) ;10 毫秒
Opt("MouseClickDragDelay", 250) ;250 毫秒
Opt("MouseCoordMode", 1) ;1=绝对坐标, 0=相对坐标, 2=客户区坐标
Opt("PixelCoordMode", 1) ;1=绝对坐标, 0=相对坐标, 2=客户区坐标
Opt("SendAttachMode", 0) ;0=不捆绑, 1=捆绑
Opt("SendCapslockMode", 1) ;1=保存并恢复, 0=不保存也恢复
Opt("SendKeyDelay", 5) ;5 毫秒
Opt("SendKeyDownDelay", 1) ;1 毫秒
Opt("TCPTimeout", 100) ;100 毫秒
Opt("TrayAutoPause", 1) ;0=不暂停, 1=暂停
Opt("TrayIconDebug", 0) ;0=不显示调试信息, 1=显示调试信息
Opt("TrayIconHide", 0) ;0=显示托盘图标, 1=隐藏托盘图标
Opt("TrayMenuMode", 0) ;0=默认菜单项目, 1=没有默认菜单, 2=不自动选中, 4=不返回菜单项目 ID
Opt("TrayOnEventMode", 0) ;0=disable, 1=enable
Opt("WinDetectHiddenText", 0) ;0=禁用事件函数通知, 1=启用事件函数通知
Opt("WinSearchChildren", 1) ;0=仅搜索顶层窗口, 1=搜索顶层窗口及子窗口
Opt("WinTextMatchMode", 1) ;1=完全匹配, 2=快速模式
Opt("WinTitleMatchMode", 1) ;1=匹配窗口标题的开始部分, 2=匹配窗口标题的任意子串, 3=完全匹配窗口标题, 4=高级匹配模式, -1 to -4=强制根据类型匹配小写字母
Opt("WinWaitDelay", 250) ;250 毫秒

provider with jb51.net (unicode)