IfWinActive / IfWinNotActive / WinActive
检查指定的窗口是否存在且当前是否活动(在最前面).若存在,则 WinActive() 返回其唯一 ID(HWND).
IfWinActive [, WinTitle, WinText, ExcludeTitle, ExcludeText] IfWinNotActive [, WinTitle, WinText, ExcludeTitle, ExcludeText] UniqueID := WinActive("WinTitle", "WinText", "ExcludeTitle", "ExcludeText")
参数
- WinTitle
窗口标题或识别目标窗口的其他条件.请参阅 WinTitle.
- WinText
如果使用此参数, 那么它必须是目标窗口中单个文本元素的子字符串 (和内置的 Window Spy 工具显示的一样). 当 DetectHiddenText 的设置为 ON 时, 那么会检测到隐藏文本元素.
- ExcludeTitle
标题中含有此参数值的窗口将被排除. 注:由于向后兼容性,所以如果此参数准确匹配某个命令名,那么 IfWinActive 和 IfWinNotActive 会将其作为命令解释.要变通解决此问题,请使用 WinActive() 函数代替.
- ExcludeText
文本中含有此参数值的窗口将被排除.
备注
如果省略所有参数, 那么将使用 上次找到的窗口.
如果这些命令的其中一个确定了某个活动窗口为符合的匹配, 那么 上次找到的窗口 将更新为这个活动窗口. 换句话说, 如果 IfWinActive 匹配结果为 "true" 或 IfWinNotActive 匹配结果为 "false", 那么将更新 上次找到的窗口.
WinActive() 函数返回匹配指定条件的活动窗口的 唯一 ID (HWND). 如果不匹配, 则函数返回 0. 由于所有的非零数字被视为"true",所以每当 WinTitle 为活动时,if WinActive("WinTitle")
语句为真.
获取活动窗口的唯一 ID 的简便方法是使用 ActiveHwnd := WinExist("A")
.
SetWinDelay 不适用于 IfWinExist/IfWinActive.
窗口标题和文本是区分大小写的. 只有在打开 DetectHiddenWindows 设置时,才能检测到隐藏窗口.
相关
IfWinExist, SetTitleMatchMode, DetectHiddenWindows, 上次找到的窗口, WinActivate, WinWaitActive, WinWait, WinWaitClose, #IfWinActive/Exist
示例
IfWinActive, Untitled - Notepad { WinMaximize ; 最大化前面 IfWinActive 找到的记事本窗口. Send, Some text.{Enter} return } if WinActive("ahk_class Notepad") or WinActive("ahk_class" . ClassName) ; "ahk_class" 后不需要空格. WinClose ; 这里使用 上次找到的窗口.