IfWinActive / IfWinNotActive / WinActive

AutoHotKey

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

标题中含有此参数值的窗口将被排除. 注:由于向后兼容性,所以如果此参数准确匹配某个命令名,那么 IfWinActiveIfWinNotActive 会将其作为命令解释.要变通解决此问题,请使用 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  ; 这里使用 上次找到的窗口.