# WinMoveTop

将指定的窗口移到堆栈顶部, 而无需显式激活它.

    WinMoveTop WinTitle, WinText, ExcludeTitle, ExcludeText

## 参数

WinTitle, WinText, ExcludeTitle, ExcludeText

  类型: 字符串, 整数或对象

  如果这些都未设置或省略, 将使用上次找到的窗口. 否则, 为 WinTitle 指定窗口标题或其他条件, 来标识目标窗口, 和/或为 WinText 指定目标窗口的单个文本元素的子字符串(由包含的 Window Spy 实用程序显示). 如果 DetectHiddenText 已经打开, 则检测隐藏文本元素. 标题或文本包含 ExcludeTitle 或 ExcludeText 的窗口将不被考虑.

## 错误处理

如果找不到窗口, 则抛出 TargetError.

如果无法应用更改, 则抛出 OSError.

## 备注

但是, 在大多数情况下, 系统默认设置可能会导致其激活. 此外, 由于操作系统针对试图窃取用户焦点的应用程序提供保护, 因此该函数可能无效(这可能取决于诸如当前活动窗口的类型和用户正在执行的操作之类的因素). 一种可能的解决方法是通过 WinSetAlwaysOnTop 使窗口暂时始终位于顶部, 然后关闭置顶.

鼠标光标下的窗口的 ID 可以使用 MouseGetPos 来获取.

窗口标题和文本是区分大小写的. 除非 DetectHiddenWindows 被打开, 否则不会检测隐藏窗口.

## 相关

WinMoveBottom, WinSetAlwaysOnTop, 窗口函数, 控件函数

dftg