# WinMoveTop

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

    WinMoveTop WinTitle, WinText, ExcludeTitle, ExcludeText

## 参数

WinTitle

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

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

WinText

  类型: 字符串

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

ExcludeTitle

  类型: 字符串

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

ExcludeText

  类型: 字符串

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

## 错误处理

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

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

## 备注

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

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

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

## 相关

WinMoveBottom, WinSetAlwaysOnTop, Win 函数, Control 函数

dftg