WinActivate

AutoHotKey

WinActivate

激活指定的窗口(让它置于最前面).

WinActivate [, WinTitle, WinText, ExcludeTitle, ExcludeText]

参数

WinTitle

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

WinText

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

ExcludeTitle

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

ExcludeText

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

备注

如果窗口处于最小化状态, 那么会对其还原后再进行激活.在v1.1.20及以后的版本中, 窗口即使已经是激活状态,也会被还原.

在 60ms 的时间中, 会对目标窗口进行六次激活的尝试.因此, 通常不需要在 WinActivate 后使用 WinWaitActiveIfWinNotActive.

如果匹配窗口已经为活动窗口, 那么会让此窗口继续保持活动状态, 而不会激活此窗口下的其他任何匹配窗口. 一般而言, 如果有多个匹配窗口, 那么会激活最上面的 (最近使用的) 窗口. 您可以使用 WinActivateBottom 激活最下面的 (最早使用的) 窗口.

[v1.1.20+]:如果要激活的窗口处于隐藏状态并且 DetectHiddenWindows 被设置为OFF时,该窗口将永远不会视为一个匹配项. 相反,只要有一个匹配窗口是可见的,它就会被激活.

在激活一个窗口后立即激活其他的窗口, 在一些系统上任务栏按钮可能会闪烁 (取决于操作系统和设置). 要避免此问题, 请使用 #WinActivateForce.

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

已知问题: 如果脚本运行在正在被远程桌面访问的计算机或服务器上,当远程桌面客户端最小化时,WinActivate 可能会挂起.一种解决办法是使用不需要激活窗口的命令,如 ControlSendControlClick. 另一个可能的解决方法是在本地/客户端计算机的注册表上做如下设置:

; 将HKCU改成HKLM,并对该系统上的所有用户生效.
RegWrite REG_DWORD, HKCU, Software\Microsoft\Terminal Server Client
    , RemoteDesktop_SuppressWhenMinimized, 2

相关

WinActivateBottom, #WinActivateForce, SetTitleMatchMode, DetectHiddenWindows, 上次找到的窗口, IfWinExist, IfWinActive, WinWaitActive, WinWait, WinWaitClose, WinClose, GroupActivate, WinSet

示例

IfWinExist, Untitled - Notepad
    WinActivate ; 使用前面找到的窗口
else
    WinActivate, Calculator