WinExist() / IfWin[Not]Exist

检查是否存在匹配的窗口. WinExist() 返回首个匹配窗口的唯一 ID(HWND).

WinExist()

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

参数

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

返回值

函数返回首个匹配窗口的唯一 ID(HWND) (作为十六进制整数)(没有找到匹配时则为 0). 因为所有非零数字被视为 "true(真)", 所以每当 WinTitle 存在时, if WinExist(WinTitle) 语句为真.

示例

if WinExist("ahk_class Notepad") or WinExist("ahk_class" . ClassName)
    WinActivate  ; 使用上次找到的窗口.

MsgBox % "The active window's ID is " . WinExist("A")

If !WinExist("Calculator")  ; 相等于 IfWinNotExist, Calculator
     return

IfWin[Not]Exist

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

IfWinExist , WinTitle, WinText, ExcludeTitle, ExcludeText
IfWinNotExist , WinTitle, WinText, ExcludeTitle, ExcludeText

参数

WinTitle

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

WinText

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

ExcludeTitle

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

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

ExcludeText

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

备注

SetWinDelay 不适用于此命令.

示例

IfWinExist, Untitled - Notepad
{
    WinActivate  ; 自动使用上面找到的窗口.
    WinMaximize  ; 同上
    Send, Some text.{Enter}
    return
}

IfWinNotExist, Calculator
    return
else
{
    WinActivate  ; 前面的"IfWinNotExist"也设置了上次找到的窗口.
    WinMove, 40, 40  ; 把它移动到新位置.
    return
}

备注

如果省略所有参数, 那么将检查上次找到的窗口看它是否仍然存在(如果是 IfWinNotExist 则检查其是否不存在).

如果函数或命令确定了某个符合的窗口存在, 那么上次找到的窗口将更新为此窗口. 换句话说, 如果 WinExist 或 IfWinExist 计算结果为 true(真) 或 IfWinNotExist 计算结果为 false(假), 那么将更新上次找到的窗口.

要获取控件的 HWND(用于 Post/SendMessage 或 DllCall 中), 请使用 ControlGet Hwnd 或 MouseGetPos.

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

WinExist() / IfWin[Not]Exist

WinExist()

参数

返回值

示例

IfWin[Not]Exist

参数

备注

示例

备注

相关