设置在类似 WinWait 命令中 WinTitle 参数的匹配模式。
SetTitleMatchMode, MatchMode SetTitleMatchMode, Fast|Slow
下列数字的其中一个或单词 RegEx:
1: 窗口标题必须以指定的 WinTitle 开头.
2:窗口标题的某个位置必须包含 WinTitle。
3: 窗口标题必须准确匹配 WinTitle.
RegEx (v1.0.45+): 改变 WinTitle, WinText, ExcludeTitle 以及 ExcludeText 为 正则表达式. 在这些命令中使用时, 不要把正则表达式括在引号中. 例如:WinActivate Untitled.*Notepad
。RegEx 还适用于 ahk_class;例如,ahk_class IEFrame
会搜索类名包含 IEFrame 的任意窗口(这是由于在默认情况下,正则表达式在目标字符串任意位置查找匹配)。注:对于 WinText,RegEx 会分别与每个文本元素(即每个控件的文本)进行对照来寻找匹配。因此, 匹配不会横跨多个文本元素.
上面的模式还会对 ExcludeTitle 产生与 WinTitle 相同的影响。例如, 模式 3 要求被排除的窗口的标题必须准确匹配 ExcludeTitle.
Fast: 这是默认行为. 性能比起 Slow 有较大提升, 但某些类型窗口中的一些 WinText 可能无法被各种窗口命令检测到.
Slow: 速度慢得多, 但窗口命令会获取窗口中所有可能的文本以寻找 WinText 匹配. Window Spy中会显示哪些部分的窗口文本(如果有)需要慢速模式才能匹配到。
此命令影响所有窗口命令的行为, 例如 IfWinExist 和 WinActivate.
如果未指定,则 TitleMatchMode 默认为 1 和 fast 模式。
如果使用 窗口组, 则当前标题匹配模式适用于组中的每个单独的规则.
通常, 在使用标题和 快速 模式的文本无法唯一标识目标窗口时才应该使用 慢速 模式. 这是因为当任意一个应用程序窗口正忙或 "无响应" 时慢速模式会非常慢.
AutoHotkey 自带的 Window Spy 自定义版本会在单独区域中显示 slow 文本, 这样很容易判断是否需要使用 慢速 模式.
如果您想同时改变两个属性, 请执行两次命令, 例如:
SetTitleMatchMode, 2 SetTitleMatchMode, slow
内置变量 A_TitleMatchMode 和 A_TitleMatchModeSpeed 包含了当前的设置.
不管当前的 TitleMatchMode 如何,WinTitle、WinText、ExcludeTitle 和 ExcludeText 都是区分大小写的。唯一的例外是带不区分大小写选项的 RegEx 模式;例如:i)untitled - notepad
。
每个新运行的 线程 (例如 热键, 自定义菜单项 或 定时 子程序) 都会以此命令的默认设置开始. 通过在脚本的自动执行段 (脚本的顶部) 使用此命令可以改变这个默认设置.
SetWinDelay, IfWinExist, WinActivate, RegExMatch()
SetTitleMatchMode 2 ; 或: SetTitleMatchMode RegEx SetTitleMatchMode Slow ; Slow/Fast 可以独立于其他所有模式进行设置.