WinActive() / IfWin[Not]Active

检查指定的窗口是否存在且当前是否活动(在最前面). 若存在, 则 WinActive() 返回其唯一 ID(HWND).

WinActive()

UniqueID := WinActive(WinTitle , WinText, ExcludeTitle, ExcludeText)

WinTitle: 窗口标题或识别目标窗口的其他条件. 请参阅 WinTitle.
WinText: 如果使用此参数, 那么它必须是目标窗口中单个文本元素的子字符串(和内置的 Window Spy 工具显示的一样). 当 DetectHiddenText 的设置为 ON 时, 那么会检测隐藏文本元素.
ExcludeTitle: 标题中含有此参数值的窗口将被排除.
ExcludeText: 文本中含有此参数值的窗口将被排除.

函数返回匹配指定条件的活动窗口的唯一 ID(HWND)(为十六进制整数). 如果不匹配, 则函数返回 0. 因为所有非零数字被视为 "true", 所以每当 WinTitle 为活动时, if WinActive("WinTitle") 语句为真.

if WinActive("ahk_class Notepad") or WinActive("ahk_class" . ClassName)  ; "ahk_class" 后不需要空格.
    WinClose  ; 这里使用上次找到的窗口.

不推荐: 不推荐在新脚本中使用此命令. 使用 WinActive 函数作为代替.

IfWinActive , WinTitle, WinText, ExcludeTitle, ExcludeText
IfWinNotActive , WinTitle, WinText, ExcludeTitle, ExcludeText

WinTitle

窗口标题或识别目标窗口的其他条件. 请参阅 WinTitle.

WinText

如果使用此参数, 那么它必须是目标窗口中单个文本元素的子字符串(和内置的 Window Spy 工具显示的一样). 当 DetectHiddenText 的设置为 ON 时, 那么会检测到隐藏文本元素.

ExcludeTitle

标题中含有此参数值的窗口将被排除.

注意: 由于向后兼容性, 所以如果此参数准确匹配某个命令名, 那么 IfWin[Not]Active 会将其作为命令解释. 要变通解决此问题, 请使用 WinActive 函数代替.

ExcludeText

文本中含有此参数值的窗口将被排除.

SetWinDelay 不适用于此命令.

IfWinActive, Untitled - Notepad
{
    WinMaximize  ; 最大化前面 IfWinActive 找到的记事本窗口.
    Send, Some text.{Enter}
    return
}

如果省略所有参数, 那么将使用上次找到的窗口.

如果函数或命令确定了某个活动窗口为符合的匹配, 那么上次找到的窗口将更新为当前活动窗口. 换句话说, 如果 WinActive 或 IfWinActive 计算结果为 true(真) 或 IfWinNotActive 计算结果为 false(假), 那么将更新上次找到的窗口.

获取活动窗口的唯一 ID 的简便方法是使用 ActiveHwnd := WinExist("A").

窗口标题和文本是区分大小写的. 只有在打开 DetectHiddenWindows 设置时, 才能检测到隐藏窗口.