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  ; 这里使用 上次找到的窗口.