调整 AutoIt 各种函数/参数的运作方式.
AutoItSetOption ( "选项" [, 参数] )
| 选项 | 要修改的选项.请查看下面的注意部分. |
| 参数 | [可选参数] 需要分配给选项的值. 因设置的选项不同而类型与意思不同. 参考下面的注意部分. 如果没有参数, 函数会返回目前的选项值. 关键字 Default 可以用于重置选项为默认值. |
| 成功: | 返回返回上一次设置的值. |
| 失败: | 设置错误为非零. 失败可能是因为参数无效(比如选项根本不存在). |
| 选项 | 参数 |
| CaretCoordMode | 设置用于插入符(caret)函数的坐标参照,可以是绝对位置也可以是相对当前激活窗口的坐标位置. 0 = 相对激活窗口的坐标 1 = 屏幕的绝对位置(默认) 2 = 相对激活窗口客户区的坐标 |
| ExpandEnvStrings | 更改字面字符串和 % 符号的解释方式.默认情况下字符串按原文解释,此选项允许您在字符串中使用形如 %environment% 这样的环境变量,例如 "临时文件夹的路径是: %temp%". 1 = 展开环境变量(类似于 AutoIt v2) 0 = 不展开展环境变量(默认) 若未设置此选项则要实现类似功能的方法是:"临时文件夹的路径是: " & EnvGet("temp") |
| ExpandVarStrings | 更改字面字符串和变量/宏($ 和 @)符号的解释方式.默认情况下字符串按原文解释,此选项允许您在字符串中使用变量和宏,例如 "变量 var1 的值是 $var1$". 1 = 展开变量(在此模式下如果要表示 $ 或 @ 本身则请用连续两个相应符号表示,例如:"这里有一个美元符号 $$"). 0 = 不展开变量(默认) |
| GUICloseOnESC | 当用户在一个GUI窗口(处于激活状态时)按下 ESC 键则$GUI_EVENT_CLOSE 消息将被发送.此选项用以切换这一行为. 1 = 在按下 ESC 时发送消息 $GUI_EVENT_CLOSE(默认). 0 = 在按下 ESC 时不发送消息 $GUI_EVENT_CLOSE |
| GUICoordMode | 设置用于 GUICtrlSetPos 函数的坐标参照. 1 = 绝对坐标(默认)将相对于对话框. 0 = 相对于上一个控件的起始位置(左上角). 2 = 相对于当前位置的坐标. A -1 for left or top parameter don't increment the start. So next line is -1,offset; next cell is offset,-1; 当前单元为 -1,-1. Obviously "offset" cannot be -1 which reserved to indicate the no increment. But if you can use a multiple of the width you choose to skip or go back. |
| GUIDataSeparatorChar | 定义 GUICtrlSetData 函数里面的分割符. 默认字符为: '|'. |
| GUIOnEventMode | 启用/关闭 OnEvent 函数通知. 0 = (默认)取消. 1 = 启用. |
| GUIResizeMode | 更改控件大小调整的模式. 0 = (默认)不调整 <1024 = 详情请查看 GUICtrlSetResizing. |
| GUIEventOptions | 修改特殊的 GUI 函数的返回值类型. 0 = (默认) 当窗口被最小化,还原,最大化,改变大小,只通知 1 = 当窗口发生最小化,最大化,改变大小,就禁止这种事件并立即发出通知,等待自定义函数进行处理. |
| MouseClickDelay | 更改每个鼠标点击命令之间的延迟时间长度. 以毫秒为单位(默认值 =10). |
| MouseClickDownDelay | 更改在松开按键之前按住按钮的时间长度. 以毫秒为单位(默认值 = 10). |
| MouseClickDragDelay | 更改鼠标开始拖曳到结束拖曳之间的时间长度. 以毫秒为单位(默认值 = 250). |
| MouseCoordMode | 设置用于鼠标函数的坐标参照,可以是绝对位置也可以是相对当前激活窗口的坐标位置. 0 = 相对激活窗口的坐标 1 = 屏幕的绝对位置(默认) 2 = 相对激活窗口客户区的坐标 |
| MustDeclareVars | 如果设置了此选项为1则所有变量在使用之前必须先使用 Dim/Local/Global 声明,这将有助于减少各种因误拼变量而引起的bug的出现. 1 = 变量必须先声明 0 = 变量不需预先声明(默认) |
| PixelCoordMode | 设置用于象素函数的坐标参照,可以是绝对位置也可以是相对当前激活窗口的坐标位置. 0 = 相对激活窗口的坐标 1 = 屏幕的绝对位置(默认) 2 = 相对激活窗口客户区的坐标 |
| SendAttachMode | SendAttachMode 指定在使用 Send() 函数时 AutoIt 是否捆绑(attach)输入线程.当不捆绑的时候(默认模式 = 0)对 capslock/scrolllock/numlock 等按键状态的检测将是不准确的(指在 NT4 下).不过,在设置捆绑模式 = 1的时候,Send("{... down/up}") 等语法将不被支持,在发送按键的时候也可能会导致系统挂起等问题.至于 ControlSend() 函数则 总是 捆绑线程的,而且不受此模式设置的影响. 0 = 不捆绑(默认) 1 = 捆绑 |
| SendCapslockMode | 指定是否让 AutoIt 在执行 Send 函数之前保存大小写切换键(CapsLock)的状态并在完成操作后恢复到原来的状态. 0 = 不保存/恢复 1 = 保存并恢复(默认) |
| SendKeyDelay | 更改发送键击命令之间的延迟时间长度. 以毫秒为单位(默认值=5).设置此值为0时也许会无效,这时请使用1代替. |
| SendKeyDownDelay | 更改在每次键击期间(松开按键之前)按住按键的时间长度.对于一些需要花费一定时间才能注册按键的应用程序,您可能就要提高这一数值. 以毫秒为单位(默认值 = 5). |
| TCPTimeout | a name="TCPTimeout">定义TCP 函数连接时最大延迟事件(超过就不再连接). 单位为毫秒(默认100毫秒) |
| TrayAutoPause | 当单击托盘图标时是否暂停. 0 = 不暂停 1 = 暂停(默认). 要是已经禁用了暂停菜单,这里失效(参考TrayMenuMode) |
| TrayIconDebug | 在托盘图标上显示当前脚本执行到的那一行的相关信息(工具提示)以助调试. 0 = 不显示调试信息(默认) 1 = 显示调试信息 |
| TrayIconHide | 隐藏 AutoIt 托盘图标.注意:托盘图标仍会在程序刚运行时出现大约 750 毫秒. 0 = 显示托盘图标(默认) 1 = 隐藏托盘图标 |
| TrayMenuMode | 扩展脚本在 系统托盘图标/菜单里面的事件. 这个选项可以结合多个选项: 0 = 默认菜单项目(脚本暂停中.../退出) 扩展到系统托盘图标; 用户添加的项目自动的取消选中; 如果您双击系统托盘图标,那么返回值为默认样式 (default). 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). |
; 可直接复制所需语句到脚本中 ;最先列出的是各项属性的默认值
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=取消, 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("MustDeclareVars", 0) ;0=无需声明变量, 1=需要预先声明
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=没有自动 check, 4=菜单项目ID 不返回
Opt("TrayOnEventMode",0) ;0=关闭, 1=启用
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=Nocase
Opt("WinWaitDelay", 250) ;250 毫秒