WinGetPos

获取指定窗口的位置和大小.

WinGetPos &OutX, &OutY, &OutWidth, &OutHeight, WinTitle, WinText, ExcludeTitle, ExcludeText

参数

&OutX, &OutY

类型: VarRef

如果省略, 将不会存储相应的值. 否则, 请指定用于存储目标窗口左上角的 X 和 Y 坐标的变量的引用.

&OutWidth, &OutHeight

类型: VarRef

如果省略, 将不会存储相应的值. 否则, 请指定用于目标窗口的宽度和高度的变量的引用.

WinTitle, WinText, ExcludeTitle, ExcludeText

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

如果这些都是空白或省略, 将使用上次找到的窗口. 否则, 为 WinTitle 指定窗口标题或其他条件, 来标识目标窗口, 和/或为 WinText 指定目标窗口的单个文本元素的子字符串(由包含的 Window Spy 实用程序显示).

ExcludeTitle 和 ExcludeText 可用于根据标题或文本排除一个或多个窗口. 它们的规范类似于 WinTitle 和 WinText, 除了 ExcludeTitle 不识别除窗口标题之外的任何条件.

窗口标题和文本是区分大小写的. 默认情况下, 不检测隐藏窗口, 而检测隐藏文本元素, 除非使用 DetectHiddenWindows 和 DetectHiddenText 进行更改. 默认情况下, 窗口标题的任意位置包含 WinTitle 或 ExcludeTitle 就能形成匹配, 除非使用 SetTitleMatchMode 进行了更改.

错误处理

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

备注

如果 WinTitle 是 "Program Manager", 那么此函数会获取桌面的大小, 这通常与当前的屏幕分辨率相同.

最小化的窗口同样含有位置和大小. 此时返回的值可能因操作系统和配置而变化, but are usually -32000 for the X and Y coordinates and zero for the width and height..

要获取鼠标当前悬停的窗口和控件的名称, 请使用 MouseGetPos.

由于此函数返回的坐标包括窗口的标题栏, 菜单和边框, 它们可能取决于操作系统版本和主题. 要在不同的系统之间获得更一致的值, 可以考虑使用 WinGetClientPos.

在具有不同 DPI 设置的多个屏幕的系统上, 由于操作系统 DPI 缩放, 返回的位置和大小可能与预期不同.

相关

WinMove, WinGetClientPos, ControlGetPos, WinGetTitle, WinGetText, ControlGetText

示例

获取和报告计算器的位置和大小.

WinGetPos &X, &Y, &W, &H, "Calculator"
MsgBox "Calculator is at " X "," Y " and its size is " W "x" H

WinGetPos &X, &Y,,, "A"
MsgBox "The active window is at " X "," Y

if WinExist("Untitled - Notepad")
{
    WinGetPos &Xpos, &Ypos ; 使用由 WinExist 找到的窗口.
    MsgBox "Notepad is at " Xpos "," Ypos
}