Function Reference

首页  后退  前进

AutoItSetOption

 

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

 

AutoItSetOption ( "option" [, param] )

参数

option

要修改的选项. 见备注.

param

[可选] 分配给选项的值. 因选项的不同而类型与意义不同, 见备注.

如果不提供参数值, 则函数仅返回已分配给选项的值.

关键字 Default 用于将选项的参数重置为默认值.

返回值

成功:

返回先前设置的选项值.

失败:

设置 @error 为非 0, 如果参数无效 (例如一个不存在的选项), 将使函数失败.

备注

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

 

选项与参数如下:

设置

参数

CaretCoordMode

设置 caret(插入符)函数使用的坐标是否参照当前激活窗口的相对坐标或绝对坐标:

   0 = 激活窗口的相对坐标

   1 = (默认值)绝对屏幕坐标

   2 = 激活窗口客户区的相对坐标

ExpandEnvStrings

更改字符串原意和 % 符号的字面解释方式. 默认字符串按原文解释.

此选项允许在字符串中使用形如 %environment% 的环境变量, 例如 "临时文件夹路径: %temp%".

   0 = (默认值)不展开展环境变量

   1 = 展开环境变量

若不设置此选项, 则实现类似功能的方法是: "临时文件夹路径: " & EnvGet("temp")

ExpandVarStrings

更改原意字符串和变量/宏 ($ and @) 符号的字面解释方式. 默认字符串按原文解释.

此选项允许在字符串中使用变量和宏,例如, "变量 var1 的值是 $var1$".

   0 = (默认值)不展开变量(默认)

   1 = 展开变量. 在此模式下如果要表示 $ 或 @ 本身, 则请用连续两个相应符号表示, 例如:"这里有一个美元符号 $$"

GUICloseOnESC

在 GUI 窗口按下 ESC 键, 将发送 $GUI_EVENT_CLOSE (关闭)消息. 此选项用以切换这一行为.

   0 = 按下 ESC 时不发送 $GUI_EVENT_CLOSE (关闭)消息.

   1 = (默认值)按下 ESC 时 Send() 发送 $GUI_EVENT_CLOSE (关闭)消息

GUICoordMode

修改 GUICtrlSetPos() 定义的控件位置.

   0 = 相对于上一个控件的起始位置(左上角).

   1 = (默认值)相对于对话框的绝对坐标(默认).

   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

设置鼠标函数的坐标是否参照当前激活窗口的相对坐标或绝对屏幕坐标:

   0 = 激活窗口的相对坐标

   1 = (默认值)绝对屏幕坐标

   2 = 激活窗口客户区的相对坐标

MustDeclareVars

如果使用此选项, 则所有变量在使用之前必须使用 Dim / Local / Global 预先声明

这将有助于减少拼写错误造成变量错误的机会.

   0 = (默认值)变量不需预先声明

   1 = 变量必需预先声明. 声明变量的详细信息参考 Dim / Global / Local / Const

PixelCoordMode

设置象素函数的坐标是否参照相句柄定义窗口(默认为激活窗口)的相对坐标或绝对屏幕坐标:

   0 = 定义窗口的相对坐标

   1 = (默认值)绝对屏幕坐标

   2 = 定义窗口客户区的相对坐标

SendAttachMode

指定使用 Send() 函数时 AutoIt 是否附加输入线程.

当不附加(默认模式=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)

函数示例

; copy any you want to change   ;default value is listed first
Opt("CaretCoordMode", 1) ;1=absolute, 0=relative, 2=client
Opt("ExpandEnvStrings", 0) ;0=don't expand, 1=do expand
Opt("ExpandVarStrings", 0) ;0=don't expand, 1=do expand
Opt("GUICloseOnESC", 1) ;1=ESC  closes, 0=ESC won't close
Opt("GUICoordMode", 1) ;1=absolute, 0=relative, 2=cell
Opt("GUIDataSeparatorChar", "|") ;"|" is the default
Opt("GUIOnEventMode", 0) ;0=disabled, 1=OnEvent mode enabled
Opt("GUIResizeMode", 0) ;0=no resizing, <1024 special resizing
Opt("GUIEventOptions", 0) ;0=default, 1=just notification, 2=GUICtrlRead tab index
Opt("MouseClickDelay", 10) ;10 milliseconds
Opt("MouseClickDownDelay", 10) ;10 milliseconds
Opt("MouseClickDragDelay", 250) ;250 milliseconds
Opt("MouseCoordMode", 1) ;1=absolute, 0=relative, 2=client
Opt("MustDeclareVars", 0) ;0=no, 1=require pre-declaration
Opt("PixelCoordMode", 1) ;1=absolute, 0=relative, 2=client
Opt("SendAttachMode", 0) ;0=don't attach, 1=do attach
Opt("SendCapslockMode", 1) ;1=store and restore, 0=don't
Opt("SendKeyDelay", 5) ;5 milliseconds
Opt("SendKeyDownDelay", 1) ;1 millisecond
Opt("TCPTimeout", 100) ;100 milliseconds
Opt("TrayAutoPause", 1) ;0=no pause, 1=Pause
Opt("TrayIconDebug", 0) ;0=no info, 1=debug line info
Opt("TrayIconHide", 0) ;0=show, 1=hide tray icon
Opt("TrayMenuMode", 0) ;0=append, 1=no default menu, 2=no automatic check, 4=menuitemID  not return
Opt("TrayOnEventMode", 0) ;0=disable, 1=enable
Opt("WinDetectHiddenText", 0) ;0=don't detect, 1=do detect
Opt("WinSearchChildren", 1) ;0=no, 1=search children also
Opt("WinTextMatchMode", 1) ;1=complete, 2=quick
Opt("WinTitleMatchMode", 1) ;1=start, 2=subStr, 3=exact, 4=advanced, -1 to -4=Nocase
Opt("WinWaitDelay", 250) ;250 milliseconds

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